tmp/developer.github.com/v3/index.html GitHub API v3 | GitHub Developer Guide

Overview

This describes the resources that make up the official GitHub REST API v3. If you have any problems or requests please contact GitHub support.

Current version

By default, all requests to https://api.github.com receive the v3 version of the REST API. We encourage you to explicitly request this version via the Accept header.

Accept: application/vnd.github.v3+json

For information about GitHub's GraphQL API v4, see the v4 documentation.

Schema

All API access is over HTTPS, and accessed from the https://api.github.com. All data is sent and received as JSON.

curl -i https://api.github.com/users/octocat/orgs

HTTP/1.1 200 OK
Server: nginx
Date: Fri, 12 Oct 2012 23:33:14 GMT
Content-Type: application/json; charset=utf-8
Connection: keep-alive
Status: 200 OK
ETag: "a00049ba79152d03380c34652f2cb612"
X-GitHub-Media-Type: github.v3
X-RateLimit-Limit: 5000
X-RateLimit-Remaining: 4987
X-RateLimit-Reset: 1350085394
Content-Length: 5
Cache-Control: max-age=0, private, must-revalidate
X-Content-Type-Options: nosniff

Blank fields are included as null instead of being omitted.

All timestamps return in ISO 8601 format:

YYYY-MM-DDTHH:MM:SSZ

For more information about time zones in timestamps, see this section.

Summary representations

When you fetch a list of resources, the response includes a subset of the attributes for that resource. This is the "summary" representation of the resource. (Some attributes are computationally expensive for the API to provide. For performance reasons, the summary representation excludes those attributes. To obtain those attributes, fetch the "detailed" representation.)

Example: When you get a list of repositories, you get the summary representation of each repository. Here, we fetch the list of repositories owned by the octokit organization:

GET /orgs/octokit/repos

Detailed representations

When you fetch an individual resource, the response typically includes all attributes for that resource. This is the "detailed" representation of the resource. (Note that authorization sometimes influences the amount of detail included in the representation.)

Example: When you get an individual repository, you get the detailed representation of the repository. Here, we fetch the octokit/octokit.rb repository:

GET /repos/octokit/octokit.rb

The documentation provides an example response for each API method. The example response illustrates all attributes that are returned by that method.

Authentication

There are three ways to authenticate through GitHub API v3. Requests that require authentication will return 404 Not Found, instead of 403 Forbidden, in some places. This is to prevent the accidental leakage of private repositories to unauthorized users.

Basic authentication

curl -u "username" https://api.github.com

OAuth2 token (sent in a header)

curl -H "Authorization: token OAUTH-TOKEN" https://api.github.com

OAuth2 token (sent as a parameter)

curl https://api.github.com/?access_token=OAUTH-TOKEN

Read more about OAuth2. Note that OAuth2 tokens can be acquired programmatically, for applications that are not websites.

OAuth2 key/secret

curl 'https://api.github.com/users/whatever?client_id=xxxx&client_secret=yyyy'

This should only be used in server to server scenarios. Don't leak your OAuth application's client secret to your users.

Read more about unauthenticated rate limiting.

Failed login limit

Authenticating with invalid credentials will return 401 Unauthorized:

curl -i https://api.github.com -u foo:bar
HTTP/1.1 401 Unauthorized

{
  "message": "Bad credentials",
  "documentation_url": "https://developer.github.com/v3"
}

After detecting several requests with invalid credentials within a short period, the API will temporarily reject all authentication attempts for that user (including ones with valid credentials) with 403 Forbidden:

curl -i https://api.github.com -u valid_username:valid_password
HTTP/1.1 403 Forbidden

{
  "message": "Maximum number of login attempts exceeded. Please try again later.",
  "documentation_url": "https://developer.github.com/v3"
}

Parameters

Many API methods take optional parameters. For GET requests, any parameters not specified as a segment in the path can be passed as an HTTP query string parameter:

curl -i "https://api.github.com/repos/vmg/redcarpet/issues?state=closed"

In this example, the 'vmg' and 'redcarpet' values are provided for the :owner and :repo parameters in the path while :state is passed in the query string.

For POST, PATCH, PUT, and DELETE requests, parameters not included in the URL should be encoded as JSON with a Content-Type of 'application/json':

curl -i -u username -d '{"scopes":["public_repo"]}' https://api.github.com/authorizations

Root endpoint

You can issue a GET request to the root endpoint to get all the endpoint categories that the REST API v3 supports:

curl https://api.github.com

GraphQL global relay IDs

Warning: The API may change without advance notice during the preview period. Preview features are not supported for production use. If you experience any issues, contact GitHub support.

When preparing to migrate to the GraphQL API v4, you can use the jean-grey API preview to expose the GraphQL Relay ID of many resources from within the REST API v3. Just provide a custom media type in the Accept header:

application/vnd.github.jean-grey-preview+json

The response will include a node_id field.

For example, if you request the authenticated user:

curl -i -u username:$token -H "Accept:application/vnd.github.jean-grey-preview+json" \
https://api.github.com/user

you'll get a response that includes the node_id of the authenticated user:

Status: 200 OK
{
  "login": "octocat",
  "id": 1,
  "avatar_url": "https://github.com/images/error/octocat_happy.gif",
  "gravatar_id": "",
  "url": "https://api.github.com/users/octocat",
  "html_url": "https://github.com/octocat",
  "followers_url": "https://api.github.com/users/octocat/followers",
  "following_url": "https://api.github.com/users/octocat/following{/other_user}",
  "gists_url": "https://api.github.com/users/octocat/gists{/gist_id}",
  "starred_url": "https://api.github.com/users/octocat/starred{/owner}{/repo}",
  "subscriptions_url": "https://api.github.com/users/octocat/subscriptions",
  "organizations_url": "https://api.github.com/users/octocat/orgs",
  "repos_url": "https://api.github.com/users/octocat/repos",
  "events_url": "https://api.github.com/users/octocat/events{/privacy}",
  "received_events_url": "https://api.github.com/users/octocat/received_events",
  "type": "User",
  "site_admin": false,
  "name": "monalisa octocat",
  "company": "GitHub",
  "blog": "https://github.com/blog",
  "location": "San Francisco",
  "email": "octocat@github.com",
  "hireable": false,
  "bio": "There once was...",
  "public_repos": 2,
  "public_gists": 1,
  "followers": 20,
  "following": 0,
  "created_at": "2008-01-14T04:33:35Z",
  "updated_at": "2008-01-14T04:33:35Z",
  "total_private_repos": 100,
  "owned_private_repos": 100,
  "private_gists": 81,
  "disk_usage": 10000,
  "collaborators": 8,
  "two_factor_authentication": true,
  "plan": {
    "name": "Medium",
    "space": 400,
    "private_repos": 20,
    "collaborators": 0
  },
  "node_id": "MDQ6VXNlcjU4MzIzMQ=="
}

You can use the node_id value (MDQ6VXNlcjU4MzIzMQ== in this example) to reference a specific node in the GraphQL API v4. Just provide the node ID, and you can access data on the underlying type.

You may find it easiest to use inline fragments to accomplish this. For example:

query {
  node(id:"MDQ6VXNlcjU4MzIzMQ==") {
   ... on User {
      id
      name
      login
    }
  }
}

See the blog post announcement for a list of REST API v3 resources that will include the node_id in responses under this API preview.

When building tools and integrations that use either the REST API v3 or the GraphQL API v4, it's best practice to persist this ID value so you can easily reference objects from the other API version. For more information, see "Migrating from REST to GraphQL."

Client errors

There are three possible types of client errors on API calls that receive request bodies:

  1. Sending invalid JSON will result in a 400 Bad Request response.

    HTTP/1.1 400 Bad Request
    Content-Length: 35
    
    {"message":"Problems parsing JSON"}
    
  2. Sending the wrong type of JSON values will result in a 400 Bad Request response.

    HTTP/1.1 400 Bad Request
    Content-Length: 40
    
    {"message":"Body should be a JSON object"}
    
  3. Sending invalid fields will result in a 422 Unprocessable Entity response.

    HTTP/1.1 422 Unprocessable Entity
    Content-Length: 149
    
    {
      "message": "Validation Failed",
      "errors": [
        {
          "resource": "Issue",
          "field": "title",
          "code": "missing_field"
        }
      ]
    }
    

All error objects have resource and field properties so that your client can tell what the problem is. There's also an error code to let you know what is wrong with the field. These are the possible validation error codes:

Error Name Description
missing This means a resource does not exist.
missing_field This means a required field on a resource has not been set.
invalid This means the formatting of a field is invalid. The documentation for that resource should be able to give you more specific information.
already_exists This means another resource has the same value as this field. This can happen in resources that must have some unique key (such as Label names).

Resources may also send custom validation errors (where code is custom). Custom errors will always have a message field describing the error, and most errors will also include a documentation_url field pointing to some content that might help you resolve the error.

HTTP redirects

API v3 uses HTTP redirection where appropriate. Clients should assume that any request may result in a redirection. Receiving an HTTP redirection is not an error and clients should follow that redirect. Redirect responses will have a Location header field which contains the URI of the resource to which the client should repeat the requests.

Status Code Description
301 Permanent redirection. The URI you used to make the request has been superseded by the one specified in the Location header field. This and all future requests to this resource should be directed to the new URI.
302, 307 Temporary redirection. The request should be repeated verbatim to the URI specified in the Location header field but clients should continue to use the original URI for future requests.

Other redirection status codes may be used in accordance with the HTTP 1.1 spec.

HTTP verbs

Where possible, API v3 strives to use appropriate HTTP verbs for each action.

Verb Description
HEAD Can be issued against any resource to get just the HTTP header info.
GET Used for retrieving resources.
POST Used for creating resources.
PATCH Used for updating resources with partial JSON data. For instance, an Issue resource has title and body attributes. A PATCH request may accept one or more of the attributes to update the resource. PATCH is a relatively new and uncommon HTTP verb, so resource endpoints also accept POST requests.
PUT Used for replacing resources or collections. For PUT requests with no body attribute, be sure to set the Content-Length header to zero.
DELETE Used for deleting resources.

Hypermedia

All resources may have one or more *_url properties linking to other resources. These are meant to provide explicit URLs so that proper API clients don't need to construct URLs on their own. It is highly recommended that API clients use these. Doing so will make future upgrades of the API easier for developers. All URLs are expected to be proper RFC 6570 URI templates.

You can then expand these templates using something like the uri_template gem:

>> tmpl = URITemplate.new('/notifications{?since,all,participating}')
>> tmpl.expand
=> "/notifications"

>> tmpl.expand :all => 1
=> "/notifications?all=1"

>> tmpl.expand :all => 1, :participating => 1
=> "/notifications?all=1&participating=1"

Pagination

Requests that return multiple items will be paginated to 30 items by default. You can specify further pages with the ?page parameter. For some resources, you can also set a custom page size up to 100 with the ?per_page parameter. Note that for technical reasons not all endpoints respect the ?per_page parameter, see events for example.

curl 'https://api.github.com/user/repos?page=2&per_page=100'

Note that page numbering is 1-based and that omitting the ?page parameter will return the first page.

For more information on pagination, check out our guide on Traversing with Pagination.

Link header

Note: It's important to form calls with Link header values instead of constructing your own URLs.

The Link header includes pagination information:

Link: <https://api.github.com/user/repos?page=3&per_page=100>; rel="next",
  <https://api.github.com/user/repos?page=50&per_page=100>; rel="last"

The example includes a line break for readability.

This Link response header contains one or more Hypermedia link relations, some of which may require expansion as URI templates.

The possible rel values are:

Name Description
next The link relation for the immediate next page of results.
last The link relation for the last page of results.
first The link relation for the first page of results.
prev The link relation for the immediate previous page of results.

Rate limiting

For requests using Basic Authentication or OAuth, you can make up to 5000 requests per hour. Authenticated requests are associated with the authenticated user, regardless of whether Basic Authentication or an OAuth token was used. This means that all OAuth applications authorized by a user share the same quota of 5000 requests per hour when they authenticate with different tokens owned by the same user.

For unauthenticated requests, the rate limit allows for up to 60 requests per hour. Unauthenticated requests are associated with the originating IP address, and not the user making requests.

Note that the Search API has custom rate limit rules.

The returned HTTP headers of any API request show your current rate limit status:

curl -i https://api.github.com/users/octocat
HTTP/1.1 200 OK
Date: Mon, 01 Jul 2013 17:27:06 GMT
Status: 200 OK
X-RateLimit-Limit: 60
X-RateLimit-Remaining: 56
X-RateLimit-Reset: 1372700873
Header Name Description
X-RateLimit-Limit The maximum number of requests you're permitted to make per hour.
X-RateLimit-Remaining The number of requests remaining in the current rate limit window.
X-RateLimit-Reset The time at which the current rate limit window resets in UTC epoch seconds.

If you need the time in a different format, any modern programming language can get the job done. For example, if you open up the console on your web browser, you can easily get the reset time as a JavaScript Date object.

new Date(1372700873 * 1000)
// => Mon Jul 01 2013 13:47:53 GMT-0400 (EDT)

If you exceed the rate limit, an error response returns:

HTTP/1.1 403 Forbidden
Date: Tue, 20 Aug 2013 14:50:41 GMT
Status: 403 Forbidden
X-RateLimit-Limit: 60
X-RateLimit-Remaining: 0
X-RateLimit-Reset: 1377013266

{
   "message": "API rate limit exceeded for xxx.xxx.xxx.xxx. (But here's the good news: Authenticated requests get a higher rate limit. Check out the documentation for more details.)",
   "documentation_url": "https://developer.github.com/v3/#rate-limiting"
}

You can check your rate limit status without incurring an API hit.

Increasing the unauthenticated rate limit for OAuth applications

If your OAuth application needs to make unauthenticated calls with a higher rate limit, you can pass your app's client ID and secret as part of the query string.

curl -i 'https://api.github.com/users/whatever?client_id=xxxx&client_secret=yyyy'
HTTP/1.1 200 OK
Date: Mon, 01 Jul 2013 17:27:06 GMT
Status: 200 OK
X-RateLimit-Limit: 5000
X-RateLimit-Remaining: 4966
X-RateLimit-Reset: 1372700873

Note: Never share your client secret with anyone or include it in client-side browser code. Use the method shown here only for server-to-server calls.

Staying within the rate limit

If you exceed your rate limit using Basic Authentication or OAuth, you can likely fix the issue by caching API responses and using conditional requests.

Abuse rate limits

To protect the quality of service on GitHub, additional rate limits may apply to some actions. For example: rapidly creating content, polling aggressively instead of using webhooks, making API calls with a high concurrency, or repeatedly requesting data that is computationally expensive may result in abuse rate limiting.

Abuse rate limits are not intended to interfere with legitimate use of the API. Your normal rate limits should be the only limit you target. To ensure you're acting as a good API citizen, check out our Best Practices guidelines.

If your application triggers this rate limit, you'll receive an informative response:

HTTP/1.1 403 Forbidden
Content-Type: application/json; charset=utf-8
Connection: close

{
  "message": "You have triggered an abuse detection mechanism and have been temporarily blocked from content creation. Please retry your request again later.",
  "documentation_url": "https://developer.github.com/v3/#abuse-rate-limits"
}

User agent required

All API requests MUST include a valid User-Agent header. Requests with no User-Agent header will be rejected. We request that you use your GitHub username, or the name of your application, for the User-Agent header value. This allows us to contact you if there are problems.

Here's an example:

User-Agent: Awesome-Octocat-App

cURL sends a valid User-Agent header by default. If you provide an invalid User-Agent header via cURL (or via an alternative client), you will receive a 403 Forbidden response:

curl -iH 'User-Agent: ' https://api.github.com/meta
HTTP/1.0 403 Forbidden
Connection: close
Content-Type: text/html

Request forbidden by administrative rules.
Please make sure your request has a User-Agent header.
Check https://developer.github.com for other possible causes.

Conditional requests

Most responses return an ETag header. Many responses also return a Last-Modified header. You can use the values of these headers to make subsequent requests to those resources using the If-None-Match and If-Modified-Since headers, respectively. If the resource has not changed, the server will return a 304 Not Modified.

Note: Making a conditional request and receiving a 304 response does not count against your Rate Limit, so we encourage you to use it whenever possible.

curl -i https://api.github.com/user
HTTP/1.1 200 OK
Cache-Control: private, max-age=60
ETag: "644b5b0155e6404a9cc4bd9d8b1ae730"
Last-Modified: Thu, 05 Jul 2012 15:31:30 GMT
Status: 200 OK
Vary: Accept, Authorization, Cookie
X-RateLimit-Limit: 5000
X-RateLimit-Remaining: 4996
X-RateLimit-Reset: 1372700873

curl -i https://api.github.com/user -H 'If-None-Match: "644b5b0155e6404a9cc4bd9d8b1ae730"'
HTTP/1.1 304 Not Modified
Cache-Control: private, max-age=60
ETag: "644b5b0155e6404a9cc4bd9d8b1ae730"
Last-Modified: Thu, 05 Jul 2012 15:31:30 GMT
Status: 304 Not Modified
Vary: Accept, Authorization, Cookie
X-RateLimit-Limit: 5000
X-RateLimit-Remaining: 4996
X-RateLimit-Reset: 1372700873

curl -i https://api.github.com/user -H "If-Modified-Since: Thu, 05 Jul 2012 15:31:30 GMT"
HTTP/1.1 304 Not Modified
Cache-Control: private, max-age=60
Last-Modified: Thu, 05 Jul 2012 15:31:30 GMT
Status: 304 Not Modified
Vary: Accept, Authorization, Cookie
X-RateLimit-Limit: 5000
X-RateLimit-Remaining: 4996
X-RateLimit-Reset: 1372700873

Cross origin resource sharing

The API supports Cross Origin Resource Sharing (CORS) for AJAX requests from any origin. You can read the CORS W3C Recommendation, or this intro from the HTML 5 Security Guide.

Here's a sample request sent from a browser hitting http://example.com:

curl -i https://api.github.com -H "Origin: http://example.com"
HTTP/1.1 302 Found
Access-Control-Allow-Origin: *
Access-Control-Expose-Headers: ETag, Link, X-GitHub-OTP, X-RateLimit-Limit, X-RateLimit-Remaining, X-RateLimit-Reset, X-OAuth-Scopes, X-Accepted-OAuth-Scopes, X-Poll-Interval

This is what the CORS preflight request looks like:

curl -i https://api.github.com -H "Origin: http://example.com" -X OPTIONS
HTTP/1.1 204 No Content
Access-Control-Allow-Origin: *
Access-Control-Allow-Headers: Authorization, Content-Type, If-Match, If-Modified-Since, If-None-Match, If-Unmodified-Since, X-GitHub-OTP, X-Requested-With
Access-Control-Allow-Methods: GET, POST, PATCH, PUT, DELETE
Access-Control-Expose-Headers: ETag, Link, X-GitHub-OTP, X-RateLimit-Limit, X-RateLimit-Remaining, X-RateLimit-Reset, X-OAuth-Scopes, X-Accepted-OAuth-Scopes, X-Poll-Interval
Access-Control-Max-Age: 86400

JSON-P callbacks

You can send a ?callback parameter to any GET call to have the results wrapped in a JSON function. This is typically used when browsers want to embed GitHub content in web pages by getting around cross domain issues. The response includes the same data output as the regular API, plus the relevant HTTP Header information.

curl https://api.github.com?callback=foo

/**/foo({
  "meta": {
    "status": 200,
    "X-RateLimit-Limit": "5000",
    "X-RateLimit-Remaining": "4966",
    "X-RateLimit-Reset": "1372700873",
    "Link": [ // pagination headers and other links
      ["https://api.github.com?page=2", {"rel": "next"}]
    ]
  },
  "data": {
    // the data
  }
})

You can write a JavaScript handler to process the callback. Here's a minimal example you can try out:

<html>
<head>
<script type="text/javascript">
function foo(response) {
  var meta = response.meta;
  var data = response.data;
  console.log(meta);
  console.log(data);
}

var script = document.createElement('script');
script.src = 'https://api.github.com?callback=foo';

document.getElementsByTagName('head')[0].appendChild(script);
</script>
</head>

<body>
  <p>Open up your browser's console.</p>
</body>
</html>

All of the headers are the same String value as the HTTP Headers with one notable exception: Link. Link headers are pre-parsed for you and come through as an array of [url, options] tuples.

A link that looks like this:

Link: <url1>; rel="next", <url2>; rel="foo"; bar="baz"

... will look like this in the Callback output:

{
  "Link": [
    [
      "url1",
      {
        "rel": "next"
      }
    ],
    [
      "url2",
      {
        "rel": "foo",
        "bar": "baz"
      }
    ]
  ]
}

Timezones

Some requests allow for specifying timestamps or generate timestamps with time zone information. We apply the following rules, in order of priority, to determine timezone information for API calls.

Explicitly provide an ISO 8601 timestamp with timezone information

For API calls that allow for a timestamp to be specified, we use that exact timestamp. An example of this is the Commits API.

These timestamps look something like 2014-02-27T15:05:06+01:00. Also see this example for how these timestamps can be specified.

Using the Time-Zone header

It is possible to supply a Time-Zone header which defines a timezone according to the list of names from the Olson database.

curl -H "Time-Zone: Europe/Amsterdam" -X POST https://api.github.com/repos/github/linguist/contents/new_file.md

This means that we generate a timestamp for the moment your API call is made in the timezone this header defines. For example, the Contents API generates a git commit for each addition or change and uses the current time as the timestamp. This header will determine the timezone used for generating that current timestamp.

Using the last known timezone for the user

If no Time-Zone header is specified and you make an authenticated call to the API, we use the last known timezone for the authenticated user. The last known timezone is updated whenever you browse the GitHub website.

UTC

If the steps above don't result in any information, we use UTC as the timezone to create the git commit.

tmp/developer.github.com/v3/activity/index.html Activity | GitHub Developer Guide

Activity

Serving up the 'social' in Social Coding, the Activity APIs provide access to notifications, subscriptions, and timelines.

Events

The Events API is a read-only interface to all the event types that power the various activity streams on GitHub.

Feeds

List of Atom feeds available for the authenticated user.

Notifications

Notifications of new comments are delivered to users. The Notifications API lets you view these notifications and mark them as read.

Starring

Repository Starring is a feature that lets users bookmark repositories. Stars are shown next to repositories to show an approximate level of interest. Stars have no effect on notifications or the activity feed.

Watching

Watching a Repository registers the user to receive notifications on new discussions, as well as events in the user's activity feed.

tmp/developer.github.com/v3/activity/events/index.html Events | GitHub Developer Guide

Events

This is a read-only API to the GitHub events. These events power the various activity streams on the site.

Events are optimized for polling with the "ETag" header. If no new events have been triggered, you will see a "304 Not Modified" response, and your current rate limit will be untouched. There is also an "X-Poll-Interval" header that specifies how often (in seconds) you are allowed to poll. In times of high server load, the time may increase. Please obey the header.

curl -I https://api.github.com/users/tater/events
HTTP/1.1 200 OK
X-Poll-Interval: 60
ETag: "a18c3bded88eb5dbb5c849a489412bf3"

# The quotes around the ETag value are important
curl -I https://api.github.com/users/tater/events \
   -H 'If-None-Match: "a18c3bded88eb5dbb5c849a489412bf3"'
HTTP/1.1 304 Not Modified
X-Poll-Interval: 60

Events support pagination, however the per_page option is unsupported. The fixed page size is 30 items. Fetching up to ten pages is supported, for a total of 300 events.

Only events created within the past 90 days will be included in timelines. Events older than 90 days will not be included (even if the total number of events in the timeline is less than 300).

All Events have the same response format:

Status: 200 OK
Link: <https://api.github.com/resource?page=2>; rel="next",
      <https://api.github.com/resource?page=5>; rel="last"
[
  {
    "type": "Event",
    "public": true,
    "payload": {
    },
    "repo": {
      "id": 3,
      "name": "octocat/Hello-World",
      "url": "https://api.github.com/repos/octocat/Hello-World"
    },
    "actor": {
      "id": 1,
      "login": "octocat",
      "gravatar_id": "",
      "avatar_url": "https://github.com/images/error/octocat_happy.gif",
      "url": "https://api.github.com/users/octocat"
    },
    "org": {
      "id": 1,
      "login": "github",
      "gravatar_id": "",
      "url": "https://api.github.com/orgs/github",
      "avatar_url": "https://github.com/images/error/octocat_happy.gif"
    },
    "created_at": "2011-09-06T17:26:27Z",
    "id": "12345"
  }
]

List public events

GET /events

List repository events

GET /repos/:owner/:repo/events

List issue events for a repository

Repository issue events have a different format than other events, as documented in the Issue Events API.

GET /repos/:owner/:repo/issues/events

List public events for a network of repositories

GET /networks/:owner/:repo/events

List public events for an organization

GET /orgs/:org/events

List events that a user has received

These are events that you've received by watching repos and following users. If you are authenticated as the given user, you will see private events. Otherwise, you'll only see public events.

GET /users/:username/received_events

List public events that a user has received

GET /users/:username/received_events/public

List events performed by a user

If you are authenticated as the given user, you will see your private events. Otherwise, you'll only see public events.

GET /users/:username/events

List public events performed by a user

GET /users/:username/events/public

List events for an organization

This is the user's organization dashboard. You must be authenticated as the user to view this.

GET /users/:username/events/orgs/:org
tmp/developer.github.com/v3/activity/events/types/index.html Event Types & Payloads | GitHub Developer Guide

Event Types & Payloads

Each event has a similar JSON schema, but a unique payload object that is determined by its event type.

Event names are used by repository webhooks to specify which events the webhook should receive. The included payloads below are from webhook deliveries but match events returned by the Events API (except where noted). The Events API uses the CamelCased name (e.g. CommitCommentEvent) in the type field of an event object and does not include the repository or sender fields in the event payload object.

Note: Some of these events may not be rendered in timelines, they're only created for various internal and webhook purposes.

CommitCommentEvent

Triggered when a commit comment is created.

Events API payload

Key Type Description
comment object The comment itself.

Webhook event name

commit_comment

Webhook payload example

{
  "action": "created",
  "comment": {
    "url": "https://api.github.com/repos/baxterthehacker/public-repo/comments/11056394",
    "html_url": "https://github.com/baxterthehacker/public-repo/commit/9049f1265b7d61be4a8904a9a27120d2064dab3b#commitcomment-11056394",
    "id": 11056394,
    "user": {
      "login": "baxterthehacker",
      "id": 6752317,
      "avatar_url": "https://avatars.githubusercontent.com/u/6752317?v=3",
      "gravatar_id": "",
      "url": "https://api.github.com/users/baxterthehacker",
      "html_url": "https://github.com/baxterthehacker",
      "followers_url": "https://api.github.com/users/baxterthehacker/followers",
      "following_url": "https://api.github.com/users/baxterthehacker/following{/other_user}",
      "gists_url": "https://api.github.com/users/baxterthehacker/gists{/gist_id}",
      "starred_url": "https://api.github.com/users/baxterthehacker/starred{/owner}{/repo}",
      "subscriptions_url": "https://api.github.com/users/baxterthehacker/subscriptions",
      "organizations_url": "https://api.github.com/users/baxterthehacker/orgs",
      "repos_url": "https://api.github.com/users/baxterthehacker/repos",
      "events_url": "https://api.github.com/users/baxterthehacker/events{/privacy}",
      "received_events_url": "https://api.github.com/users/baxterthehacker/received_events",
      "type": "User",
      "site_admin": false
    },
    "position": null,
    "line": null,
    "path": null,
    "commit_id": "9049f1265b7d61be4a8904a9a27120d2064dab3b",
    "created_at": "2015-05-05T23:40:29Z",
    "updated_at": "2015-05-05T23:40:29Z",
    "body": "This is a really good change! :+1:"
  },
  "repository": {
    "id": 35129377,
    "name": "public-repo",
    "full_name": "baxterthehacker/public-repo",
    "owner": {
      "login": "baxterthehacker",
      "id": 6752317,
      "avatar_url": "https://avatars.githubusercontent.com/u/6752317?v=3",
      "gravatar_id": "",
      "url": "https://api.github.com/users/baxterthehacker",
      "html_url": "https://github.com/baxterthehacker",
      "followers_url": "https://api.github.com/users/baxterthehacker/followers",
      "following_url": "https://api.github.com/users/baxterthehacker/following{/other_user}",
      "gists_url": "https://api.github.com/users/baxterthehacker/gists{/gist_id}",
      "starred_url": "https://api.github.com/users/baxterthehacker/starred{/owner}{/repo}",
      "subscriptions_url": "https://api.github.com/users/baxterthehacker/subscriptions",
      "organizations_url": "https://api.github.com/users/baxterthehacker/orgs",
      "repos_url": "https://api.github.com/users/baxterthehacker/repos",
      "events_url": "https://api.github.com/users/baxterthehacker/events{/privacy}",
      "received_events_url": "https://api.github.com/users/baxterthehacker/received_events",
      "type": "User",
      "site_admin": false
    },
    "private": false,
    "html_url": "https://github.com/baxterthehacker/public-repo",
    "description": "",
    "fork": false,
    "url": "https://api.github.com/repos/baxterthehacker/public-repo",
    "forks_url": "https://api.github.com/repos/baxterthehacker/public-repo/forks",
    "keys_url": "https://api.github.com/repos/baxterthehacker/public-repo/keys{/key_id}",
    "collaborators_url": "https://api.github.com/repos/baxterthehacker/public-repo/collaborators{/collaborator}",
    "teams_url": "https://api.github.com/repos/baxterthehacker/public-repo/teams",
    "hooks_url": "https://api.github.com/repos/baxterthehacker/public-repo/hooks",
    "issue_events_url": "https://api.github.com/repos/baxterthehacker/public-repo/issues/events{/number}",
    "events_url": "https://api.github.com/repos/baxterthehacker/public-repo/events",
    "assignees_url": "https://api.github.com/repos/baxterthehacker/public-repo/assignees{/user}",
    "branches_url": "https://api.github.com/repos/baxterthehacker/public-repo/branches{/branch}",
    "tags_url": "https://api.github.com/repos/baxterthehacker/public-repo/tags",
    "blobs_url": "https://api.github.com/repos/baxterthehacker/public-repo/git/blobs{/sha}",
    "git_tags_url": "https://api.github.com/repos/baxterthehacker/public-repo/git/tags{/sha}",
    "git_refs_url": "https://api.github.com/repos/baxterthehacker/public-repo/git/refs{/sha}",
    "trees_url": "https://api.github.com/repos/baxterthehacker/public-repo/git/trees{/sha}",
    "statuses_url": "https://api.github.com/repos/baxterthehacker/public-repo/statuses/{sha}",
    "languages_url": "https://api.github.com/repos/baxterthehacker/public-repo/languages",
    "stargazers_url": "https://api.github.com/repos/baxterthehacker/public-repo/stargazers",
    "contributors_url": "https://api.github.com/repos/baxterthehacker/public-repo/contributors",
    "subscribers_url": "https://api.github.com/repos/baxterthehacker/public-repo/subscribers",
    "subscription_url": "https://api.github.com/repos/baxterthehacker/public-repo/subscription",
    "commits_url": "https://api.github.com/repos/baxterthehacker/public-repo/commits{/sha}",
    "git_commits_url": "https://api.github.com/repos/baxterthehacker/public-repo/git/commits{/sha}",
    "comments_url": "https://api.github.com/repos/baxterthehacker/public-repo/comments{/number}",
    "issue_comment_url": "https://api.github.com/repos/baxterthehacker/public-repo/issues/comments{/number}",
    "contents_url": "https://api.github.com/repos/baxterthehacker/public-repo/contents/{+path}",
    "compare_url": "https://api.github.com/repos/baxterthehacker/public-repo/compare/{base}...{head}",
    "merges_url": "https://api.github.com/repos/baxterthehacker/public-repo/merges",
    "archive_url": "https://api.github.com/repos/baxterthehacker/public-repo/{archive_format}{/ref}",
    "downloads_url": "https://api.github.com/repos/baxterthehacker/public-repo/downloads",
    "issues_url": "https://api.github.com/repos/baxterthehacker/public-repo/issues{/number}",
    "pulls_url": "https://api.github.com/repos/baxterthehacker/public-repo/pulls{/number}",
    "milestones_url": "https://api.github.com/repos/baxterthehacker/public-repo/milestones{/number}",
    "notifications_url": "https://api.github.com/repos/baxterthehacker/public-repo/notifications{?since,all,participating}",
    "labels_url": "https://api.github.com/repos/baxterthehacker/public-repo/labels{/name}",
    "releases_url": "https://api.github.com/repos/baxterthehacker/public-repo/releases{/id}",
    "created_at": "2015-05-05T23:40:12Z",
    "updated_at": "2015-05-05T23:40:12Z",
    "pushed_at": "2015-05-05T23:40:27Z",
    "git_url": "git://github.com/baxterthehacker/public-repo.git",
    "ssh_url": "git@github.com:baxterthehacker/public-repo.git",
    "clone_url": "https://github.com/baxterthehacker/public-repo.git",
    "svn_url": "https://github.com/baxterthehacker/public-repo",
    "homepage": null,
    "size": 0,
    "stargazers_count": 0,
    "watchers_count": 0,
    "language": null,
    "has_issues": true,
    "has_downloads": true,
    "has_wiki": true,
    "has_pages": true,
    "forks_count": 0,
    "mirror_url": null,
    "open_issues_count": 2,
    "forks": 0,
    "open_issues": 2,
    "watchers": 0,
    "default_branch": "master"
  },
  "sender": {
    "login": "baxterthehacker",
    "id": 6752317,
    "avatar_url": "https://avatars.githubusercontent.com/u/6752317?v=3",
    "gravatar_id": "",
    "url": "https://api.github.com/users/baxterthehacker",
    "html_url": "https://github.com/baxterthehacker",
    "followers_url": "https://api.github.com/users/baxterthehacker/followers",
    "following_url": "https://api.github.com/users/baxterthehacker/following{/other_user}",
    "gists_url": "https://api.github.com/users/baxterthehacker/gists{/gist_id}",
    "starred_url": "https://api.github.com/users/baxterthehacker/starred{/owner}{/repo}",
    "subscriptions_url": "https://api.github.com/users/baxterthehacker/subscriptions",
    "organizations_url": "https://api.github.com/users/baxterthehacker/orgs",
    "repos_url": "https://api.github.com/users/baxterthehacker/repos",
    "events_url": "https://api.github.com/users/baxterthehacker/events{/privacy}",
    "received_events_url": "https://api.github.com/users/baxterthehacker/received_events",
    "type": "User",
    "site_admin": false
  }
}

CreateEvent

Represents a created repository, branch, or tag.

Note: webhooks will not receive this event for created repositories. Additionally, webhooks will not receive this event for tags if more than three tags are pushed at once.

Events API payload

Key Type Description
ref_type string The object that was created. Can be one of "repository", "branch", or "tag"
ref string The git ref (or null if only a repository was created).
master_branch string The name of the repository's default branch (usually master).
description string The repository's current description.

Webhook event name

create

Webhook payload example

{
  "ref": "0.0.1",
  "ref_type": "tag",
  "master_branch": "master",
  "description": "",
  "pusher_type": "user",
  "repository": {
    "id": 35129377,
    "name": "public-repo",
    "full_name": "baxterthehacker/public-repo",
    "owner": {
      "login": "baxterthehacker",
      "id": 6752317,
      "avatar_url": "https://avatars.githubusercontent.com/u/6752317?v=3",
      "gravatar_id": "",
      "url": "https://api.github.com/users/baxterthehacker",
      "html_url": "https://github.com/baxterthehacker",
      "followers_url": "https://api.github.com/users/baxterthehacker/followers",
      "following_url": "https://api.github.com/users/baxterthehacker/following{/other_user}",
      "gists_url": "https://api.github.com/users/baxterthehacker/gists{/gist_id}",
      "starred_url": "https://api.github.com/users/baxterthehacker/starred{/owner}{/repo}",
      "subscriptions_url": "https://api.github.com/users/baxterthehacker/subscriptions",
      "organizations_url": "https://api.github.com/users/baxterthehacker/orgs",
      "repos_url": "https://api.github.com/users/baxterthehacker/repos",
      "events_url": "https://api.github.com/users/baxterthehacker/events{/privacy}",
      "received_events_url": "https://api.github.com/users/baxterthehacker/received_events",
      "type": "User",
      "site_admin": false
    },
    "private": false,
    "html_url": "https://github.com/baxterthehacker/public-repo",
    "description": "",
    "fork": false,
    "url": "https://api.github.com/repos/baxterthehacker/public-repo",
    "forks_url": "https://api.github.com/repos/baxterthehacker/public-repo/forks",
    "keys_url": "https://api.github.com/repos/baxterthehacker/public-repo/keys{/key_id}",
    "collaborators_url": "https://api.github.com/repos/baxterthehacker/public-repo/collaborators{/collaborator}",
    "teams_url": "https://api.github.com/repos/baxterthehacker/public-repo/teams",
    "hooks_url": "https://api.github.com/repos/baxterthehacker/public-repo/hooks",
    "issue_events_url": "https://api.github.com/repos/baxterthehacker/public-repo/issues/events{/number}",
    "events_url": "https://api.github.com/repos/baxterthehacker/public-repo/events",
    "assignees_url": "https://api.github.com/repos/baxterthehacker/public-repo/assignees{/user}",
    "branches_url": "https://api.github.com/repos/baxterthehacker/public-repo/branches{/branch}",
    "tags_url": "https://api.github.com/repos/baxterthehacker/public-repo/tags",
    "blobs_url": "https://api.github.com/repos/baxterthehacker/public-repo/git/blobs{/sha}",
    "git_tags_url": "https://api.github.com/repos/baxterthehacker/public-repo/git/tags{/sha}",
    "git_refs_url": "https://api.github.com/repos/baxterthehacker/public-repo/git/refs{/sha}",
    "trees_url": "https://api.github.com/repos/baxterthehacker/public-repo/git/trees{/sha}",
    "statuses_url": "https://api.github.com/repos/baxterthehacker/public-repo/statuses/{sha}",
    "languages_url": "https://api.github.com/repos/baxterthehacker/public-repo/languages",
    "stargazers_url": "https://api.github.com/repos/baxterthehacker/public-repo/stargazers",
    "contributors_url": "https://api.github.com/repos/baxterthehacker/public-repo/contributors",
    "subscribers_url": "https://api.github.com/repos/baxterthehacker/public-repo/subscribers",
    "subscription_url": "https://api.github.com/repos/baxterthehacker/public-repo/subscription",
    "commits_url": "https://api.github.com/repos/baxterthehacker/public-repo/commits{/sha}",
    "git_commits_url": "https://api.github.com/repos/baxterthehacker/public-repo/git/commits{/sha}",
    "comments_url": "https://api.github.com/repos/baxterthehacker/public-repo/comments{/number}",
    "issue_comment_url": "https://api.github.com/repos/baxterthehacker/public-repo/issues/comments{/number}",
    "contents_url": "https://api.github.com/repos/baxterthehacker/public-repo/contents/{+path}",
    "compare_url": "https://api.github.com/repos/baxterthehacker/public-repo/compare/{base}...{head}",
    "merges_url": "https://api.github.com/repos/baxterthehacker/public-repo/merges",
    "archive_url": "https://api.github.com/repos/baxterthehacker/public-repo/{archive_format}{/ref}",
    "downloads_url": "https://api.github.com/repos/baxterthehacker/public-repo/downloads",
    "issues_url": "https://api.github.com/repos/baxterthehacker/public-repo/issues{/number}",
    "pulls_url": "https://api.github.com/repos/baxterthehacker/public-repo/pulls{/number}",
    "milestones_url": "https://api.github.com/repos/baxterthehacker/public-repo/milestones{/number}",
    "notifications_url": "https://api.github.com/repos/baxterthehacker/public-repo/notifications{?since,all,participating}",
    "labels_url": "https://api.github.com/repos/baxterthehacker/public-repo/labels{/name}",
    "releases_url": "https://api.github.com/repos/baxterthehacker/public-repo/releases{/id}",
    "created_at": "2015-05-05T23:40:12Z",
    "updated_at": "2015-05-05T23:40:30Z",
    "pushed_at": "2015-05-05T23:40:38Z",
    "git_url": "git://github.com/baxterthehacker/public-repo.git",
    "ssh_url": "git@github.com:baxterthehacker/public-repo.git",
    "clone_url": "https://github.com/baxterthehacker/public-repo.git",
    "svn_url": "https://github.com/baxterthehacker/public-repo",
    "homepage": null,
    "size": 0,
    "stargazers_count": 0,
    "watchers_count": 0,
    "language": null,
    "has_issues": true,
    "has_downloads": true,
    "has_wiki": true,
    "has_pages": true,
    "forks_count": 0,
    "mirror_url": null,
    "open_issues_count": 2,
    "forks": 0,
    "open_issues": 2,
    "watchers": 0,
    "default_branch": "master"
  },
  "sender": {
    "login": "baxterthehacker",
    "id": 6752317,
    "avatar_url": "https://avatars.githubusercontent.com/u/6752317?v=3",
    "gravatar_id": "",
    "url": "https://api.github.com/users/baxterthehacker",
    "html_url": "https://github.com/baxterthehacker",
    "followers_url": "https://api.github.com/users/baxterthehacker/followers",
    "following_url": "https://api.github.com/users/baxterthehacker/following{/other_user}",
    "gists_url": "https://api.github.com/users/baxterthehacker/gists{/gist_id}",
    "starred_url": "https://api.github.com/users/baxterthehacker/starred{/owner}{/repo}",
    "subscriptions_url": "https://api.github.com/users/baxterthehacker/subscriptions",
    "organizations_url": "https://api.github.com/users/baxterthehacker/orgs",
    "repos_url": "https://api.github.com/users/baxterthehacker/repos",
    "events_url": "https://api.github.com/users/baxterthehacker/events{/privacy}",
    "received_events_url": "https://api.github.com/users/baxterthehacker/received_events",
    "type": "User",
    "site_admin": false
  }
}

DeleteEvent

Represents a deleted branch or tag.

Note: webhooks will not receive this event for tags if more than three tags are deleted at once.

Events API payload

Key Type Description
ref_type string The object that was deleted. Can be "branch" or "tag".
ref string The full git ref.

Webhook event name

delete

Webhook payload example

{
  "ref": "simple-tag",
  "ref_type": "tag",
  "pusher_type": "user",
  "repository": {
    "id": 35129377,
    "name": "public-repo",
    "full_name": "baxterthehacker/public-repo",
    "owner": {
      "login": "baxterthehacker",
      "id": 6752317,
      "avatar_url": "https://avatars.githubusercontent.com/u/6752317?v=3",
      "gravatar_id": "",
      "url": "https://api.github.com/users/baxterthehacker",
      "html_url": "https://github.com/baxterthehacker",
      "followers_url": "https://api.github.com/users/baxterthehacker/followers",
      "following_url": "https://api.github.com/users/baxterthehacker/following{/other_user}",
      "gists_url": "https://api.github.com/users/baxterthehacker/gists{/gist_id}",
      "starred_url": "https://api.github.com/users/baxterthehacker/starred{/owner}{/repo}",
      "subscriptions_url": "https://api.github.com/users/baxterthehacker/subscriptions",
      "organizations_url": "https://api.github.com/users/baxterthehacker/orgs",
      "repos_url": "https://api.github.com/users/baxterthehacker/repos",
      "events_url": "https://api.github.com/users/baxterthehacker/events{/privacy}",
      "received_events_url": "https://api.github.com/users/baxterthehacker/received_events",
      "type": "User",
      "site_admin": false
    },
    "private": false,
    "html_url": "https://github.com/baxterthehacker/public-repo",
    "description": "",
    "fork": false,
    "url": "https://api.github.com/repos/baxterthehacker/public-repo",
    "forks_url": "https://api.github.com/repos/baxterthehacker/public-repo/forks",
    "keys_url": "https://api.github.com/repos/baxterthehacker/public-repo/keys{/key_id}",
    "collaborators_url": "https://api.github.com/repos/baxterthehacker/public-repo/collaborators{/collaborator}",
    "teams_url": "https://api.github.com/repos/baxterthehacker/public-repo/teams",
    "hooks_url": "https://api.github.com/repos/baxterthehacker/public-repo/hooks",
    "issue_events_url": "https://api.github.com/repos/baxterthehacker/public-repo/issues/events{/number}",
    "events_url": "https://api.github.com/repos/baxterthehacker/public-repo/events",
    "assignees_url": "https://api.github.com/repos/baxterthehacker/public-repo/assignees{/user}",
    "branches_url": "https://api.github.com/repos/baxterthehacker/public-repo/branches{/branch}",
    "tags_url": "https://api.github.com/repos/baxterthehacker/public-repo/tags",
    "blobs_url": "https://api.github.com/repos/baxterthehacker/public-repo/git/blobs{/sha}",
    "git_tags_url": "https://api.github.com/repos/baxterthehacker/public-repo/git/tags{/sha}",
    "git_refs_url": "https://api.github.com/repos/baxterthehacker/public-repo/git/refs{/sha}",
    "trees_url": "https://api.github.com/repos/baxterthehacker/public-repo/git/trees{/sha}",
    "statuses_url": "https://api.github.com/repos/baxterthehacker/public-repo/statuses/{sha}",
    "languages_url": "https://api.github.com/repos/baxterthehacker/public-repo/languages",
    "stargazers_url": "https://api.github.com/repos/baxterthehacker/public-repo/stargazers",
    "contributors_url": "https://api.github.com/repos/baxterthehacker/public-repo/contributors",
    "subscribers_url": "https://api.github.com/repos/baxterthehacker/public-repo/subscribers",
    "subscription_url": "https://api.github.com/repos/baxterthehacker/public-repo/subscription",
    "commits_url": "https://api.github.com/repos/baxterthehacker/public-repo/commits{/sha}",
    "git_commits_url": "https://api.github.com/repos/baxterthehacker/public-repo/git/commits{/sha}",
    "comments_url": "https://api.github.com/repos/baxterthehacker/public-repo/comments{/number}",
    "issue_comment_url": "https://api.github.com/repos/baxterthehacker/public-repo/issues/comments{/number}",
    "contents_url": "https://api.github.com/repos/baxterthehacker/public-repo/contents/{+path}",
    "compare_url": "https://api.github.com/repos/baxterthehacker/public-repo/compare/{base}...{head}",
    "merges_url": "https://api.github.com/repos/baxterthehacker/public-repo/merges",
    "archive_url": "https://api.github.com/repos/baxterthehacker/public-repo/{archive_format}{/ref}",
    "downloads_url": "https://api.github.com/repos/baxterthehacker/public-repo/downloads",
    "issues_url": "https://api.github.com/repos/baxterthehacker/public-repo/issues{/number}",
    "pulls_url": "https://api.github.com/repos/baxterthehacker/public-repo/pulls{/number}",
    "milestones_url": "https://api.github.com/repos/baxterthehacker/public-repo/milestones{/number}",
    "notifications_url": "https://api.github.com/repos/baxterthehacker/public-repo/notifications{?since,all,participating}",
    "labels_url": "https://api.github.com/repos/baxterthehacker/public-repo/labels{/name}",
    "releases_url": "https://api.github.com/repos/baxterthehacker/public-repo/releases{/id}",
    "created_at": "2015-05-05T23:40:12Z",
    "updated_at": "2015-05-05T23:40:30Z",
    "pushed_at": "2015-05-05T23:40:40Z",
    "git_url": "git://github.com/baxterthehacker/public-repo.git",
    "ssh_url": "git@github.com:baxterthehacker/public-repo.git",
    "clone_url": "https://github.com/baxterthehacker/public-repo.git",
    "svn_url": "https://github.com/baxterthehacker/public-repo",
    "homepage": null,
    "size": 0,
    "stargazers_count": 0,
    "watchers_count": 0,
    "language": null,
    "has_issues": true,
    "has_downloads": true,
    "has_wiki": true,
    "has_pages": true,
    "forks_count": 0,
    "mirror_url": null,
    "open_issues_count": 2,
    "forks": 0,
    "open_issues": 2,
    "watchers": 0,
    "default_branch": "master"
  },
  "sender": {
    "login": "baxterthehacker",
    "id": 6752317,
    "avatar_url": "https://avatars.githubusercontent.com/u/6752317?v=3",
    "gravatar_id": "",
    "url": "https://api.github.com/users/baxterthehacker",
    "html_url": "https://github.com/baxterthehacker",
    "followers_url": "https://api.github.com/users/baxterthehacker/followers",
    "following_url": "https://api.github.com/users/baxterthehacker/following{/other_user}",
    "gists_url": "https://api.github.com/users/baxterthehacker/gists{/gist_id}",
    "starred_url": "https://api.github.com/users/baxterthehacker/starred{/owner}{/repo}",
    "subscriptions_url": "https://api.github.com/users/baxterthehacker/subscriptions",
    "organizations_url": "https://api.github.com/users/baxterthehacker/orgs",
    "repos_url": "https://api.github.com/users/baxterthehacker/repos",
    "events_url": "https://api.github.com/users/baxterthehacker/events{/privacy}",
    "received_events_url": "https://api.github.com/users/baxterthehacker/received_events",
    "type": "User",
    "site_admin": false
  }
}

DeploymentEvent

Represents a deployment.

Events of this type are not visible in timelines. These events are only used to trigger hooks.

Events API payload

Key Type Description
deployment object The deployment.
repository object The repository for this deployment.

Webhook event name

deployment

Webhook payload example

{
  "deployment": {
    "url": "https://api.github.com/repos/baxterthehacker/public-repo/deployments/710692",
    "id": 710692,
    "sha": "9049f1265b7d61be4a8904a9a27120d2064dab3b",
    "ref": "master",
    "task": "deploy",
    "payload": {
    },
    "environment": "production",
    "description": null,
    "creator": {
      "login": "baxterthehacker",
      "id": 6752317,
      "avatar_url": "https://avatars.githubusercontent.com/u/6752317?v=3",
      "gravatar_id": "",
      "url": "https://api.github.com/users/baxterthehacker",
      "html_url": "https://github.com/baxterthehacker",
      "followers_url": "https://api.github.com/users/baxterthehacker/followers",
      "following_url": "https://api.github.com/users/baxterthehacker/following{/other_user}",
      "gists_url": "https://api.github.com/users/baxterthehacker/gists{/gist_id}",
      "starred_url": "https://api.github.com/users/baxterthehacker/starred{/owner}{/repo}",
      "subscriptions_url": "https://api.github.com/users/baxterthehacker/subscriptions",
      "organizations_url": "https://api.github.com/users/baxterthehacker/orgs",
      "repos_url": "https://api.github.com/users/baxterthehacker/repos",
      "events_url": "https://api.github.com/users/baxterthehacker/events{/privacy}",
      "received_events_url": "https://api.github.com/users/baxterthehacker/received_events",
      "type": "User",
      "site_admin": false
    },
    "created_at": "2015-05-05T23:40:38Z",
    "updated_at": "2015-05-05T23:40:38Z",
    "statuses_url": "https://api.github.com/repos/baxterthehacker/public-repo/deployments/710692/statuses",
    "repository_url": "https://api.github.com/repos/baxterthehacker/public-repo"
  },
  "repository": {
    "id": 35129377,
    "name": "public-repo",
    "full_name": "baxterthehacker/public-repo",
    "owner": {
      "login": "baxterthehacker",
      "id": 6752317,
      "avatar_url": "https://avatars.githubusercontent.com/u/6752317?v=3",
      "gravatar_id": "",
      "url": "https://api.github.com/users/baxterthehacker",
      "html_url": "https://github.com/baxterthehacker",
      "followers_url": "https://api.github.com/users/baxterthehacker/followers",
      "following_url": "https://api.github.com/users/baxterthehacker/following{/other_user}",
      "gists_url": "https://api.github.com/users/baxterthehacker/gists{/gist_id}",
      "starred_url": "https://api.github.com/users/baxterthehacker/starred{/owner}{/repo}",
      "subscriptions_url": "https://api.github.com/users/baxterthehacker/subscriptions",
      "organizations_url": "https://api.github.com/users/baxterthehacker/orgs",
      "repos_url": "https://api.github.com/users/baxterthehacker/repos",
      "events_url": "https://api.github.com/users/baxterthehacker/events{/privacy}",
      "received_events_url": "https://api.github.com/users/baxterthehacker/received_events",
      "type": "User",
      "site_admin": false
    },
    "private": false,
    "html_url": "https://github.com/baxterthehacker/public-repo",
    "description": "",
    "fork": false,
    "url": "https://api.github.com/repos/baxterthehacker/public-repo",
    "forks_url": "https://api.github.com/repos/baxterthehacker/public-repo/forks",
    "keys_url": "https://api.github.com/repos/baxterthehacker/public-repo/keys{/key_id}",
    "collaborators_url": "https://api.github.com/repos/baxterthehacker/public-repo/collaborators{/collaborator}",
    "teams_url": "https://api.github.com/repos/baxterthehacker/public-repo/teams",
    "hooks_url": "https://api.github.com/repos/baxterthehacker/public-repo/hooks",
    "issue_events_url": "https://api.github.com/repos/baxterthehacker/public-repo/issues/events{/number}",
    "events_url": "https://api.github.com/repos/baxterthehacker/public-repo/events",
    "assignees_url": "https://api.github.com/repos/baxterthehacker/public-repo/assignees{/user}",
    "branches_url": "https://api.github.com/repos/baxterthehacker/public-repo/branches{/branch}",
    "tags_url": "https://api.github.com/repos/baxterthehacker/public-repo/tags",
    "blobs_url": "https://api.github.com/repos/baxterthehacker/public-repo/git/blobs{/sha}",
    "git_tags_url": "https://api.github.com/repos/baxterthehacker/public-repo/git/tags{/sha}",
    "git_refs_url": "https://api.github.com/repos/baxterthehacker/public-repo/git/refs{/sha}",
    "trees_url": "https://api.github.com/repos/baxterthehacker/public-repo/git/trees{/sha}",
    "statuses_url": "https://api.github.com/repos/baxterthehacker/public-repo/statuses/{sha}",
    "languages_url": "https://api.github.com/repos/baxterthehacker/public-repo/languages",
    "stargazers_url": "https://api.github.com/repos/baxterthehacker/public-repo/stargazers",
    "contributors_url": "https://api.github.com/repos/baxterthehacker/public-repo/contributors",
    "subscribers_url": "https://api.github.com/repos/baxterthehacker/public-repo/subscribers",
    "subscription_url": "https://api.github.com/repos/baxterthehacker/public-repo/subscription",
    "commits_url": "https://api.github.com/repos/baxterthehacker/public-repo/commits{/sha}",
    "git_commits_url": "https://api.github.com/repos/baxterthehacker/public-repo/git/commits{/sha}",
    "comments_url": "https://api.github.com/repos/baxterthehacker/public-repo/comments{/number}",
    "issue_comment_url": "https://api.github.com/repos/baxterthehacker/public-repo/issues/comments{/number}",
    "contents_url": "https://api.github.com/repos/baxterthehacker/public-repo/contents/{+path}",
    "compare_url": "https://api.github.com/repos/baxterthehacker/public-repo/compare/{base}...{head}",
    "merges_url": "https://api.github.com/repos/baxterthehacker/public-repo/merges",
    "archive_url": "https://api.github.com/repos/baxterthehacker/public-repo/{archive_format}{/ref}",
    "downloads_url": "https://api.github.com/repos/baxterthehacker/public-repo/downloads",
    "issues_url": "https://api.github.com/repos/baxterthehacker/public-repo/issues{/number}",
    "pulls_url": "https://api.github.com/repos/baxterthehacker/public-repo/pulls{/number}",
    "milestones_url": "https://api.github.com/repos/baxterthehacker/public-repo/milestones{/number}",
    "notifications_url": "https://api.github.com/repos/baxterthehacker/public-repo/notifications{?since,all,participating}",
    "labels_url": "https://api.github.com/repos/baxterthehacker/public-repo/labels{/name}",
    "releases_url": "https://api.github.com/repos/baxterthehacker/public-repo/releases{/id}",
    "created_at": "2015-05-05T23:40:12Z",
    "updated_at": "2015-05-05T23:40:30Z",
    "pushed_at": "2015-05-05T23:40:38Z",
    "git_url": "git://github.com/baxterthehacker/public-repo.git",
    "ssh_url": "git@github.com:baxterthehacker/public-repo.git",
    "clone_url": "https://github.com/baxterthehacker/public-repo.git",
    "svn_url": "https://github.com/baxterthehacker/public-repo",
    "homepage": null,
    "size": 0,
    "stargazers_count": 0,
    "watchers_count": 0,
    "language": null,
    "has_issues": true,
    "has_downloads": true,
    "has_wiki": true,
    "has_pages": true,
    "forks_count": 0,
    "mirror_url": null,
    "open_issues_count": 2,
    "forks": 0,
    "open_issues": 2,
    "watchers": 0,
    "default_branch": "master"
  },
  "sender": {
    "login": "baxterthehacker",
    "id": 6752317,
    "avatar_url": "https://avatars.githubusercontent.com/u/6752317?v=3",
    "gravatar_id": "",
    "url": "https://api.github.com/users/baxterthehacker",
    "html_url": "https://github.com/baxterthehacker",
    "followers_url": "https://api.github.com/users/baxterthehacker/followers",
    "following_url": "https://api.github.com/users/baxterthehacker/following{/other_user}",
    "gists_url": "https://api.github.com/users/baxterthehacker/gists{/gist_id}",
    "starred_url": "https://api.github.com/users/baxterthehacker/starred{/owner}{/repo}",
    "subscriptions_url": "https://api.github.com/users/baxterthehacker/subscriptions",
    "organizations_url": "https://api.github.com/users/baxterthehacker/orgs",
    "repos_url": "https://api.github.com/users/baxterthehacker/repos",
    "events_url": "https://api.github.com/users/baxterthehacker/events{/privacy}",
    "received_events_url": "https://api.github.com/users/baxterthehacker/received_events",
    "type": "User",
    "site_admin": false
  }
}

DeploymentStatusEvent

Represents a deployment status.

Events of this type are not visible in timelines. These events are only used to trigger hooks.

Events API payload

Key Type Description
deployment_status object The deployment status.
deployment_status["state"] string The new state. Can be pending, success, failure, or error.
deployment_status["target_url"] string The optional link added to the status.
deployment_status["description"] string The optional human-readable description added to the status.
deployment object The deployment that this status is associated with.
repository object The repository for this deployment.

Webhook event name

deployment_status

Webhook payload example

{
  "deployment_status": {
    "url": "https://api.github.com/repos/baxterthehacker/public-repo/deployments/710692/statuses/1115122",
    "id": 1115122,
    "state": "success",
    "creator": {
      "login": "baxterthehacker",
      "id": 6752317,
      "avatar_url": "https://avatars.githubusercontent.com/u/6752317?v=3",
      "gravatar_id": "",
      "url": "https://api.github.com/users/baxterthehacker",
      "html_url": "https://github.com/baxterthehacker",
      "followers_url": "https://api.github.com/users/baxterthehacker/followers",
      "following_url": "https://api.github.com/users/baxterthehacker/following{/other_user}",
      "gists_url": "https://api.github.com/users/baxterthehacker/gists{/gist_id}",
      "starred_url": "https://api.github.com/users/baxterthehacker/starred{/owner}{/repo}",
      "subscriptions_url": "https://api.github.com/users/baxterthehacker/subscriptions",
      "organizations_url": "https://api.github.com/users/baxterthehacker/orgs",
      "repos_url": "https://api.github.com/users/baxterthehacker/repos",
      "events_url": "https://api.github.com/users/baxterthehacker/events{/privacy}",
      "received_events_url": "https://api.github.com/users/baxterthehacker/received_events",
      "type": "User",
      "site_admin": false
    },
    "description": null,
    "target_url": null,
    "created_at": "2015-05-05T23:40:39Z",
    "updated_at": "2015-05-05T23:40:39Z",
    "deployment_url": "https://api.github.com/repos/baxterthehacker/public-repo/deployments/710692",
    "repository_url": "https://api.github.com/repos/baxterthehacker/public-repo"
  },
  "deployment": {
    "url": "https://api.github.com/repos/baxterthehacker/public-repo/deployments/710692",
    "id": 710692,
    "sha": "9049f1265b7d61be4a8904a9a27120d2064dab3b",
    "ref": "master",
    "task": "deploy",
    "payload": {
    },
    "environment": "production",
    "description": null,
    "creator": {
      "login": "baxterthehacker",
      "id": 6752317,
      "avatar_url": "https://avatars.githubusercontent.com/u/6752317?v=3",
      "gravatar_id": "",
      "url": "https://api.github.com/users/baxterthehacker",
      "html_url": "https://github.com/baxterthehacker",
      "followers_url": "https://api.github.com/users/baxterthehacker/followers",
      "following_url": "https://api.github.com/users/baxterthehacker/following{/other_user}",
      "gists_url": "https://api.github.com/users/baxterthehacker/gists{/gist_id}",
      "starred_url": "https://api.github.com/users/baxterthehacker/starred{/owner}{/repo}",
      "subscriptions_url": "https://api.github.com/users/baxterthehacker/subscriptions",
      "organizations_url": "https://api.github.com/users/baxterthehacker/orgs",
      "repos_url": "https://api.github.com/users/baxterthehacker/repos",
      "events_url": "https://api.github.com/users/baxterthehacker/events{/privacy}",
      "received_events_url": "https://api.github.com/users/baxterthehacker/received_events",
      "type": "User",
      "site_admin": false
    },
    "created_at": "2015-05-05T23:40:38Z",
    "updated_at": "2015-05-05T23:40:38Z",
    "statuses_url": "https://api.github.com/repos/baxterthehacker/public-repo/deployments/710692/statuses",
    "repository_url": "https://api.github.com/repos/baxterthehacker/public-repo"
  },
  "repository": {
    "id": 35129377,
    "name": "public-repo",
    "full_name": "baxterthehacker/public-repo",
    "owner": {
      "login": "baxterthehacker",
      "id": 6752317,
      "avatar_url": "https://avatars.githubusercontent.com/u/6752317?v=3",
      "gravatar_id": "",
      "url": "https://api.github.com/users/baxterthehacker",
      "html_url": "https://github.com/baxterthehacker",
      "followers_url": "https://api.github.com/users/baxterthehacker/followers",
      "following_url": "https://api.github.com/users/baxterthehacker/following{/other_user}",
      "gists_url": "https://api.github.com/users/baxterthehacker/gists{/gist_id}",
      "starred_url": "https://api.github.com/users/baxterthehacker/starred{/owner}{/repo}",
      "subscriptions_url": "https://api.github.com/users/baxterthehacker/subscriptions",
      "organizations_url": "https://api.github.com/users/baxterthehacker/orgs",
      "repos_url": "https://api.github.com/users/baxterthehacker/repos",
      "events_url": "https://api.github.com/users/baxterthehacker/events{/privacy}",
      "received_events_url": "https://api.github.com/users/baxterthehacker/received_events",
      "type": "User",
      "site_admin": false
    },
    "private": false,
    "html_url": "https://github.com/baxterthehacker/public-repo",
    "description": "",
    "fork": false,
    "url": "https://api.github.com/repos/baxterthehacker/public-repo",
    "forks_url": "https://api.github.com/repos/baxterthehacker/public-repo/forks",
    "keys_url": "https://api.github.com/repos/baxterthehacker/public-repo/keys{/key_id}",
    "collaborators_url": "https://api.github.com/repos/baxterthehacker/public-repo/collaborators{/collaborator}",
    "teams_url": "https://api.github.com/repos/baxterthehacker/public-repo/teams",
    "hooks_url": "https://api.github.com/repos/baxterthehacker/public-repo/hooks",
    "issue_events_url": "https://api.github.com/repos/baxterthehacker/public-repo/issues/events{/number}",
    "events_url": "https://api.github.com/repos/baxterthehacker/public-repo/events",
    "assignees_url": "https://api.github.com/repos/baxterthehacker/public-repo/assignees{/user}",
    "branches_url": "https://api.github.com/repos/baxterthehacker/public-repo/branches{/branch}",
    "tags_url": "https://api.github.com/repos/baxterthehacker/public-repo/tags",
    "blobs_url": "https://api.github.com/repos/baxterthehacker/public-repo/git/blobs{/sha}",
    "git_tags_url": "https://api.github.com/repos/baxterthehacker/public-repo/git/tags{/sha}",
    "git_refs_url": "https://api.github.com/repos/baxterthehacker/public-repo/git/refs{/sha}",
    "trees_url": "https://api.github.com/repos/baxterthehacker/public-repo/git/trees{/sha}",
    "statuses_url": "https://api.github.com/repos/baxterthehacker/public-repo/statuses/{sha}",
    "languages_url": "https://api.github.com/repos/baxterthehacker/public-repo/languages",
    "stargazers_url": "https://api.github.com/repos/baxterthehacker/public-repo/stargazers",
    "contributors_url": "https://api.github.com/repos/baxterthehacker/public-repo/contributors",
    "subscribers_url": "https://api.github.com/repos/baxterthehacker/public-repo/subscribers",
    "subscription_url": "https://api.github.com/repos/baxterthehacker/public-repo/subscription",
    "commits_url": "https://api.github.com/repos/baxterthehacker/public-repo/commits{/sha}",
    "git_commits_url": "https://api.github.com/repos/baxterthehacker/public-repo/git/commits{/sha}",
    "comments_url": "https://api.github.com/repos/baxterthehacker/public-repo/comments{/number}",
    "issue_comment_url": "https://api.github.com/repos/baxterthehacker/public-repo/issues/comments{/number}",
    "contents_url": "https://api.github.com/repos/baxterthehacker/public-repo/contents/{+path}",
    "compare_url": "https://api.github.com/repos/baxterthehacker/public-repo/compare/{base}...{head}",
    "merges_url": "https://api.github.com/repos/baxterthehacker/public-repo/merges",
    "archive_url": "https://api.github.com/repos/baxterthehacker/public-repo/{archive_format}{/ref}",
    "downloads_url": "https://api.github.com/repos/baxterthehacker/public-repo/downloads",
    "issues_url": "https://api.github.com/repos/baxterthehacker/public-repo/issues{/number}",
    "pulls_url": "https://api.github.com/repos/baxterthehacker/public-repo/pulls{/number}",
    "milestones_url": "https://api.github.com/repos/baxterthehacker/public-repo/milestones{/number}",
    "notifications_url": "https://api.github.com/repos/baxterthehacker/public-repo/notifications{?since,all,participating}",
    "labels_url": "https://api.github.com/repos/baxterthehacker/public-repo/labels{/name}",
    "releases_url": "https://api.github.com/repos/baxterthehacker/public-repo/releases{/id}",
    "created_at": "2015-05-05T23:40:12Z",
    "updated_at": "2015-05-05T23:40:30Z",
    "pushed_at": "2015-05-05T23:40:38Z",
    "git_url": "git://github.com/baxterthehacker/public-repo.git",
    "ssh_url": "git@github.com:baxterthehacker/public-repo.git",
    "clone_url": "https://github.com/baxterthehacker/public-repo.git",
    "svn_url": "https://github.com/baxterthehacker/public-repo",
    "homepage": null,
    "size": 0,
    "stargazers_count": 0,
    "watchers_count": 0,
    "language": null,
    "has_issues": true,
    "has_downloads": true,
    "has_wiki": true,
    "has_pages": true,
    "forks_count": 0,
    "mirror_url": null,
    "open_issues_count": 2,
    "forks": 0,
    "open_issues": 2,
    "watchers": 0,
    "default_branch": "master"
  },
  "sender": {
    "login": "baxterthehacker",
    "id": 6752317,
    "avatar_url": "https://avatars.githubusercontent.com/u/6752317?v=3",
    "gravatar_id": "",
    "url": "https://api.github.com/users/baxterthehacker",
    "html_url": "https://github.com/baxterthehacker",
    "followers_url": "https://api.github.com/users/baxterthehacker/followers",
    "following_url": "https://api.github.com/users/baxterthehacker/following{/other_user}",
    "gists_url": "https://api.github.com/users/baxterthehacker/gists{/gist_id}",
    "starred_url": "https://api.github.com/users/baxterthehacker/starred{/owner}{/repo}",
    "subscriptions_url": "https://api.github.com/users/baxterthehacker/subscriptions",
    "organizations_url": "https://api.github.com/users/baxterthehacker/orgs",
    "repos_url": "https://api.github.com/users/baxterthehacker/repos",
    "events_url": "https://api.github.com/users/baxterthehacker/events{/privacy}",
    "received_events_url": "https://api.github.com/users/baxterthehacker/received_events",
    "type": "User",
    "site_admin": false
  }
}

DownloadEvent

Triggered when a new download is created.

Events of this type are no longer delivered, but it's possible that they exist in timelines of some users. You cannot create webhooks that listen to these events.

Events API payload

Key Type Description
download object The download that was just created.

Webhook event name

download

FollowEvent

Triggered when a user follows another user.

Events of this type are no longer delivered, but it's possible that they exist in timelines of some users. You cannot create webhooks that listen to these events.

Events API payload

Key Type Description
target object The user that was just followed.

Webhook event name

follow

ForkEvent

Triggered when a user forks a repository.

Events API payload

Key Type Description
forkee object The created repository.

Webhook event name

fork

Webhook payload example

{
  "forkee": {
    "id": 35129393,
    "name": "public-repo",
    "full_name": "baxterandthehackers/public-repo",
    "owner": {
      "login": "baxterandthehackers",
      "id": 7649605,
      "avatar_url": "https://avatars.githubusercontent.com/u/7649605?v=3",
      "gravatar_id": "",
      "url": "https://api.github.com/users/baxterandthehackers",
      "html_url": "https://github.com/baxterandthehackers",
      "followers_url": "https://api.github.com/users/baxterandthehackers/followers",
      "following_url": "https://api.github.com/users/baxterandthehackers/following{/other_user}",
      "gists_url": "https://api.github.com/users/baxterandthehackers/gists{/gist_id}",
      "starred_url": "https://api.github.com/users/baxterandthehackers/starred{/owner}{/repo}",
      "subscriptions_url": "https://api.github.com/users/baxterandthehackers/subscriptions",
      "organizations_url": "https://api.github.com/users/baxterandthehackers/orgs",
      "repos_url": "https://api.github.com/users/baxterandthehackers/repos",
      "events_url": "https://api.github.com/users/baxterandthehackers/events{/privacy}",
      "received_events_url": "https://api.github.com/users/baxterandthehackers/received_events",
      "type": "Organization",
      "site_admin": false
    },
    "private": false,
    "html_url": "https://github.com/baxterandthehackers/public-repo",
    "description": "",
    "fork": true,
    "url": "https://api.github.com/repos/baxterandthehackers/public-repo",
    "forks_url": "https://api.github.com/repos/baxterandthehackers/public-repo/forks",
    "keys_url": "https://api.github.com/repos/baxterandthehackers/public-repo/keys{/key_id}",
    "collaborators_url": "https://api.github.com/repos/baxterandthehackers/public-repo/collaborators{/collaborator}",
    "teams_url": "https://api.github.com/repos/baxterandthehackers/public-repo/teams",
    "hooks_url": "https://api.github.com/repos/baxterandthehackers/public-repo/hooks",
    "issue_events_url": "https://api.github.com/repos/baxterandthehackers/public-repo/issues/events{/number}",
    "events_url": "https://api.github.com/repos/baxterandthehackers/public-repo/events",
    "assignees_url": "https://api.github.com/repos/baxterandthehackers/public-repo/assignees{/user}",
    "branches_url": "https://api.github.com/repos/baxterandthehackers/public-repo/branches{/branch}",
    "tags_url": "https://api.github.com/repos/baxterandthehackers/public-repo/tags",
    "blobs_url": "https://api.github.com/repos/baxterandthehackers/public-repo/git/blobs{/sha}",
    "git_tags_url": "https://api.github.com/repos/baxterandthehackers/public-repo/git/tags{/sha}",
    "git_refs_url": "https://api.github.com/repos/baxterandthehackers/public-repo/git/refs{/sha}",
    "trees_url": "https://api.github.com/repos/baxterandthehackers/public-repo/git/trees{/sha}",
    "statuses_url": "https://api.github.com/repos/baxterandthehackers/public-repo/statuses/{sha}",
    "languages_url": "https://api.github.com/repos/baxterandthehackers/public-repo/languages",
    "stargazers_url": "https://api.github.com/repos/baxterandthehackers/public-repo/stargazers",
    "contributors_url": "https://api.github.com/repos/baxterandthehackers/public-repo/contributors",
    "subscribers_url": "https://api.github.com/repos/baxterandthehackers/public-repo/subscribers",
    "subscription_url": "https://api.github.com/repos/baxterandthehackers/public-repo/subscription",
    "commits_url": "https://api.github.com/repos/baxterandthehackers/public-repo/commits{/sha}",
    "git_commits_url": "https://api.github.com/repos/baxterandthehackers/public-repo/git/commits{/sha}",
    "comments_url": "https://api.github.com/repos/baxterandthehackers/public-repo/comments{/number}",
    "issue_comment_url": "https://api.github.com/repos/baxterandthehackers/public-repo/issues/comments{/number}",
    "contents_url": "https://api.github.com/repos/baxterandthehackers/public-repo/contents/{+path}",
    "compare_url": "https://api.github.com/repos/baxterandthehackers/public-repo/compare/{base}...{head}",
    "merges_url": "https://api.github.com/repos/baxterandthehackers/public-repo/merges",
    "archive_url": "https://api.github.com/repos/baxterandthehackers/public-repo/{archive_format}{/ref}",
    "downloads_url": "https://api.github.com/repos/baxterandthehackers/public-repo/downloads",
    "issues_url": "https://api.github.com/repos/baxterandthehackers/public-repo/issues{/number}",
    "pulls_url": "https://api.github.com/repos/baxterandthehackers/public-repo/pulls{/number}",
    "milestones_url": "https://api.github.com/repos/baxterandthehackers/public-repo/milestones{/number}",
    "notifications_url": "https://api.github.com/repos/baxterandthehackers/public-repo/notifications{?since,all,participating}",
    "labels_url": "https://api.github.com/repos/baxterandthehackers/public-repo/labels{/name}",
    "releases_url": "https://api.github.com/repos/baxterandthehackers/public-repo/releases{/id}",
    "created_at": "2015-05-05T23:40:30Z",
    "updated_at": "2015-05-05T23:40:30Z",
    "pushed_at": "2015-05-05T23:40:27Z",
    "git_url": "git://github.com/baxterandthehackers/public-repo.git",
    "ssh_url": "git@github.com:baxterandthehackers/public-repo.git",
    "clone_url": "https://github.com/baxterandthehackers/public-repo.git",
    "svn_url": "https://github.com/baxterandthehackers/public-repo",
    "homepage": null,
    "size": 0,
    "stargazers_count": 0,
    "watchers_count": 0,
    "language": null,
    "has_issues": false,
    "has_downloads": true,
    "has_wiki": true,
    "has_pages": true,
    "forks_count": 0,
    "mirror_url": null,
    "open_issues_count": 0,
    "forks": 0,
    "open_issues": 0,
    "watchers": 0,
    "default_branch": "master",
    "public": true
  },
  "repository": {
    "id": 35129377,
    "name": "public-repo",
    "full_name": "baxterthehacker/public-repo",
    "owner": {
      "login": "baxterthehacker",
      "id": 6752317,
      "avatar_url": "https://avatars.githubusercontent.com/u/6752317?v=3",
      "gravatar_id": "",
      "url": "https://api.github.com/users/baxterthehacker",
      "html_url": "https://github.com/baxterthehacker",
      "followers_url": "https://api.github.com/users/baxterthehacker/followers",
      "following_url": "https://api.github.com/users/baxterthehacker/following{/other_user}",
      "gists_url": "https://api.github.com/users/baxterthehacker/gists{/gist_id}",
      "starred_url": "https://api.github.com/users/baxterthehacker/starred{/owner}{/repo}",
      "subscriptions_url": "https://api.github.com/users/baxterthehacker/subscriptions",
      "organizations_url": "https://api.github.com/users/baxterthehacker/orgs",
      "repos_url": "https://api.github.com/users/baxterthehacker/repos",
      "events_url": "https://api.github.com/users/baxterthehacker/events{/privacy}",
      "received_events_url": "https://api.github.com/users/baxterthehacker/received_events",
      "type": "User",
      "site_admin": false
    },
    "private": false,
    "html_url": "https://github.com/baxterthehacker/public-repo",
    "description": "",
    "fork": false,
    "url": "https://api.github.com/repos/baxterthehacker/public-repo",
    "forks_url": "https://api.github.com/repos/baxterthehacker/public-repo/forks",
    "keys_url": "https://api.github.com/repos/baxterthehacker/public-repo/keys{/key_id}",
    "collaborators_url": "https://api.github.com/repos/baxterthehacker/public-repo/collaborators{/collaborator}",
    "teams_url": "https://api.github.com/repos/baxterthehacker/public-repo/teams",
    "hooks_url": "https://api.github.com/repos/baxterthehacker/public-repo/hooks",
    "issue_events_url": "https://api.github.com/repos/baxterthehacker/public-repo/issues/events{/number}",
    "events_url": "https://api.github.com/repos/baxterthehacker/public-repo/events",
    "assignees_url": "https://api.github.com/repos/baxterthehacker/public-repo/assignees{/user}",
    "branches_url": "https://api.github.com/repos/baxterthehacker/public-repo/branches{/branch}",
    "tags_url": "https://api.github.com/repos/baxterthehacker/public-repo/tags",
    "blobs_url": "https://api.github.com/repos/baxterthehacker/public-repo/git/blobs{/sha}",
    "git_tags_url": "https://api.github.com/repos/baxterthehacker/public-repo/git/tags{/sha}",
    "git_refs_url": "https://api.github.com/repos/baxterthehacker/public-repo/git/refs{/sha}",
    "trees_url": "https://api.github.com/repos/baxterthehacker/public-repo/git/trees{/sha}",
    "statuses_url": "https://api.github.com/repos/baxterthehacker/public-repo/statuses/{sha}",
    "languages_url": "https://api.github.com/repos/baxterthehacker/public-repo/languages",
    "stargazers_url": "https://api.github.com/repos/baxterthehacker/public-repo/stargazers",
    "contributors_url": "https://api.github.com/repos/baxterthehacker/public-repo/contributors",
    "subscribers_url": "https://api.github.com/repos/baxterthehacker/public-repo/subscribers",
    "subscription_url": "https://api.github.com/repos/baxterthehacker/public-repo/subscription",
    "commits_url": "https://api.github.com/repos/baxterthehacker/public-repo/commits{/sha}",
    "git_commits_url": "https://api.github.com/repos/baxterthehacker/public-repo/git/commits{/sha}",
    "comments_url": "https://api.github.com/repos/baxterthehacker/public-repo/comments{/number}",
    "issue_comment_url": "https://api.github.com/repos/baxterthehacker/public-repo/issues/comments{/number}",
    "contents_url": "https://api.github.com/repos/baxterthehacker/public-repo/contents/{+path}",
    "compare_url": "https://api.github.com/repos/baxterthehacker/public-repo/compare/{base}...{head}",
    "merges_url": "https://api.github.com/repos/baxterthehacker/public-repo/merges",
    "archive_url": "https://api.github.com/repos/baxterthehacker/public-repo/{archive_format}{/ref}",
    "downloads_url": "https://api.github.com/repos/baxterthehacker/public-repo/downloads",
    "issues_url": "https://api.github.com/repos/baxterthehacker/public-repo/issues{/number}",
    "pulls_url": "https://api.github.com/repos/baxterthehacker/public-repo/pulls{/number}",
    "milestones_url": "https://api.github.com/repos/baxterthehacker/public-repo/milestones{/number}",
    "notifications_url": "https://api.github.com/repos/baxterthehacker/public-repo/notifications{?since,all,participating}",
    "labels_url": "https://api.github.com/repos/baxterthehacker/public-repo/labels{/name}",
    "releases_url": "https://api.github.com/repos/baxterthehacker/public-repo/releases{/id}",
    "created_at": "2015-05-05T23:40:12Z",
    "updated_at": "2015-05-05T23:40:30Z",
    "pushed_at": "2015-05-05T23:40:27Z",
    "git_url": "git://github.com/baxterthehacker/public-repo.git",
    "ssh_url": "git@github.com:baxterthehacker/public-repo.git",
    "clone_url": "https://github.com/baxterthehacker/public-repo.git",
    "svn_url": "https://github.com/baxterthehacker/public-repo",
    "homepage": null,
    "size": 0,
    "stargazers_count": 0,
    "watchers_count": 0,
    "language": null,
    "has_issues": true,
    "has_downloads": true,
    "has_wiki": true,
    "has_pages": true,
    "forks_count": 1,
    "mirror_url": null,
    "open_issues_count": 2,
    "forks": 1,
    "open_issues": 2,
    "watchers": 0,
    "default_branch": "master"
  },
  "sender": {
    "login": "baxterandthehackers",
    "id": 7649605,
    "avatar_url": "https://avatars.githubusercontent.com/u/7649605?v=3",
    "gravatar_id": "",
    "url": "https://api.github.com/users/baxterandthehackers",
    "html_url": "https://github.com/baxterandthehackers",
    "followers_url": "https://api.github.com/users/baxterandthehackers/followers",
    "following_url": "https://api.github.com/users/baxterandthehackers/following{/other_user}",
    "gists_url": "https://api.github.com/users/baxterandthehackers/gists{/gist_id}",
    "starred_url": "https://api.github.com/users/baxterandthehackers/starred{/owner}{/repo}",
    "subscriptions_url": "https://api.github.com/users/baxterandthehackers/subscriptions",
    "organizations_url": "https://api.github.com/users/baxterandthehackers/orgs",
    "repos_url": "https://api.github.com/users/baxterandthehackers/repos",
    "events_url": "https://api.github.com/users/baxterandthehackers/events{/privacy}",
    "received_events_url": "https://api.github.com/users/baxterandthehackers/received_events",
    "type": "Organization",
    "site_admin": false
  }
}

ForkApplyEvent

Triggered when a patch is applied in the Fork Queue.

Events of this type are no longer delivered, but it's possible that they exist in timelines of some users. You cannot create webhooks that listen to these events.

Events API payload

Key Type Description
head string The branch name the patch is applied to.
before string SHA of the repository state before the patch.
after string SHA of the repository state after the patch.

Webhook event name

fork_apply

GistEvent

Triggered when a Gist is created or updated.

Events of this type are no longer delivered, but it's possible that they exist in timelines of some users. You cannot create webhooks that listen to these events.

Events API payload

Key Type Description
action string The action that was performed. Can be "create" or "update"
gist object The gist itself.

Webhook event name

gist

GollumEvent

Triggered when a Wiki page is created or updated.

Events API payload

Key Type Description
pages array The pages that were updated.
pages[][page_name] string The name of the page.
pages[][title] string The current page title.
pages[][action] string The action that was performed on the page. Can be "created" or "edited".
pages[][sha] string The latest commit SHA of the page.
pages[][html_url] string Points to the HTML wiki page.

Webhook event name

gollum

Webhook payload example

{
  "pages": [
    {
      "page_name": "Home",
      "title": "Home",
      "summary": null,
      "action": "created",
      "sha": "91ea1bd42aa2ba166b86e8aefe049e9837214e67",
      "html_url": "https://github.com/baxterthehacker/public-repo/wiki/Home"
    }
  ],
  "repository": {
    "id": 35129377,
    "name": "public-repo",
    "full_name": "baxterthehacker/public-repo",
    "owner": {
      "login": "baxterthehacker",
      "id": 6752317,
      "avatar_url": "https://avatars.githubusercontent.com/u/6752317?v=3",
      "gravatar_id": "",
      "url": "https://api.github.com/users/baxterthehacker",
      "html_url": "https://github.com/baxterthehacker",
      "followers_url": "https://api.github.com/users/baxterthehacker/followers",
      "following_url": "https://api.github.com/users/baxterthehacker/following{/other_user}",
      "gists_url": "https://api.github.com/users/baxterthehacker/gists{/gist_id}",
      "starred_url": "https://api.github.com/users/baxterthehacker/starred{/owner}{/repo}",
      "subscriptions_url": "https://api.github.com/users/baxterthehacker/subscriptions",
      "organizations_url": "https://api.github.com/users/baxterthehacker/orgs",
      "repos_url": "https://api.github.com/users/baxterthehacker/repos",
      "events_url": "https://api.github.com/users/baxterthehacker/events{/privacy}",
      "received_events_url": "https://api.github.com/users/baxterthehacker/received_events",
      "type": "User",
      "site_admin": false
    },
    "private": false,
    "html_url": "https://github.com/baxterthehacker/public-repo",
    "description": "",
    "fork": false,
    "url": "https://api.github.com/repos/baxterthehacker/public-repo",
    "forks_url": "https://api.github.com/repos/baxterthehacker/public-repo/forks",
    "keys_url": "https://api.github.com/repos/baxterthehacker/public-repo/keys{/key_id}",
    "collaborators_url": "https://api.github.com/repos/baxterthehacker/public-repo/collaborators{/collaborator}",
    "teams_url": "https://api.github.com/repos/baxterthehacker/public-repo/teams",
    "hooks_url": "https://api.github.com/repos/baxterthehacker/public-repo/hooks",
    "issue_events_url": "https://api.github.com/repos/baxterthehacker/public-repo/issues/events{/number}",
    "events_url": "https://api.github.com/repos/baxterthehacker/public-repo/events",
    "assignees_url": "https://api.github.com/repos/baxterthehacker/public-repo/assignees{/user}",
    "branches_url": "https://api.github.com/repos/baxterthehacker/public-repo/branches{/branch}",
    "tags_url": "https://api.github.com/repos/baxterthehacker/public-repo/tags",
    "blobs_url": "https://api.github.com/repos/baxterthehacker/public-repo/git/blobs{/sha}",
    "git_tags_url": "https://api.github.com/repos/baxterthehacker/public-repo/git/tags{/sha}",
    "git_refs_url": "https://api.github.com/repos/baxterthehacker/public-repo/git/refs{/sha}",
    "trees_url": "https://api.github.com/repos/baxterthehacker/public-repo/git/trees{/sha}",
    "statuses_url": "https://api.github.com/repos/baxterthehacker/public-repo/statuses/{sha}",
    "languages_url": "https://api.github.com/repos/baxterthehacker/public-repo/languages",
    "stargazers_url": "https://api.github.com/repos/baxterthehacker/public-repo/stargazers",
    "contributors_url": "https://api.github.com/repos/baxterthehacker/public-repo/contributors",
    "subscribers_url": "https://api.github.com/repos/baxterthehacker/public-repo/subscribers",
    "subscription_url": "https://api.github.com/repos/baxterthehacker/public-repo/subscription",
    "commits_url": "https://api.github.com/repos/baxterthehacker/public-repo/commits{/sha}",
    "git_commits_url": "https://api.github.com/repos/baxterthehacker/public-repo/git/commits{/sha}",
    "comments_url": "https://api.github.com/repos/baxterthehacker/public-repo/comments{/number}",
    "issue_comment_url": "https://api.github.com/repos/baxterthehacker/public-repo/issues/comments{/number}",
    "contents_url": "https://api.github.com/repos/baxterthehacker/public-repo/contents/{+path}",
    "compare_url": "https://api.github.com/repos/baxterthehacker/public-repo/compare/{base}...{head}",
    "merges_url": "https://api.github.com/repos/baxterthehacker/public-repo/merges",
    "archive_url": "https://api.github.com/repos/baxterthehacker/public-repo/{archive_format}{/ref}",
    "downloads_url": "https://api.github.com/repos/baxterthehacker/public-repo/downloads",
    "issues_url": "https://api.github.com/repos/baxterthehacker/public-repo/issues{/number}",
    "pulls_url": "https://api.github.com/repos/baxterthehacker/public-repo/pulls{/number}",
    "milestones_url": "https://api.github.com/repos/baxterthehacker/public-repo/milestones{/number}",
    "notifications_url": "https://api.github.com/repos/baxterthehacker/public-repo/notifications{?since,all,participating}",
    "labels_url": "https://api.github.com/repos/baxterthehacker/public-repo/labels{/name}",
    "releases_url": "https://api.github.com/repos/baxterthehacker/public-repo/releases{/id}",
    "created_at": "2015-05-05T23:40:12Z",
    "updated_at": "2015-05-05T23:40:12Z",
    "pushed_at": "2015-05-05T23:40:17Z",
    "git_url": "git://github.com/baxterthehacker/public-repo.git",
    "ssh_url": "git@github.com:baxterthehacker/public-repo.git",
    "clone_url": "https://github.com/baxterthehacker/public-repo.git",
    "svn_url": "https://github.com/baxterthehacker/public-repo",
    "homepage": null,
    "size": 0,
    "stargazers_count": 0,
    "watchers_count": 0,
    "language": null,
    "has_issues": true,
    "has_downloads": true,
    "has_wiki": true,
    "has_pages": true,
    "forks_count": 0,
    "mirror_url": null,
    "open_issues_count": 0,
    "forks": 0,
    "open_issues": 0,
    "watchers": 0,
    "default_branch": "master"
  },
  "sender": {
    "login": "jasonrudolph",
    "id": 2988,
    "avatar_url": "https://avatars.githubusercontent.com/u/2988?v=3",
    "gravatar_id": "",
    "url": "https://api.github.com/users/jasonrudolph",
    "html_url": "https://github.com/jasonrudolph",
    "followers_url": "https://api.github.com/users/jasonrudolph/followers",
    "following_url": "https://api.github.com/users/jasonrudolph/following{/other_user}",
    "gists_url": "https://api.github.com/users/jasonrudolph/gists{/gist_id}",
    "starred_url": "https://api.github.com/users/jasonrudolph/starred{/owner}{/repo}",
    "subscriptions_url": "https://api.github.com/users/jasonrudolph/subscriptions",
    "organizations_url": "https://api.github.com/users/jasonrudolph/orgs",
    "repos_url": "https://api.github.com/users/jasonrudolph/repos",
    "events_url": "https://api.github.com/users/jasonrudolph/events{/privacy}",
    "received_events_url": "https://api.github.com/users/jasonrudolph/received_events",
    "type": "User",
    "site_admin": true
  }
}

InstallationEvent

Triggered when a GitHub App has been installed or uninstalled.

Events API payload

Key Type Description
action string The action that was performed. Can be either "created" or "deleted".
installation object The installation itself.

Webhook event name

installation

Webhook payload example

{
  "action": "deleted",
  "installation": {
    "id": 2,
    "account": {
      "login": "octocat",
      "id": 1,
      "avatar_url": "https://github.com/images/error/octocat_happy.gif",
      "gravatar_id": "",
      "url": "https://api.github.com/users/octocat",
      "html_url": "https://github.com/octocat",
      "followers_url": "https://api.github.com/users/octocat/followers",
      "following_url": "https://api.github.com/users/octocat/following{/other_user}",
      "gists_url": "https://api.github.com/users/octocat/gists{/gist_id}",
      "starred_url": "https://api.github.com/users/octocat/starred{/owner}{/repo}",
      "subscriptions_url": "https://api.github.com/users/octocat/subscriptions",
      "organizations_url": "https://api.github.com/users/octocat/orgs",
      "repos_url": "https://api.github.com/users/octocat/repos",
      "events_url": "https://api.github.com/users/octocat/events{/privacy}",
      "received_events_url": "https://api.github.com/users/octocat/received_events",
      "type": "User",
      "site_admin": false
    },
    "repository_selection": "selected",
    "access_tokens_url": "https://api.github.com/installations/2/access_tokens",
    "repositories_url": "https://api.github.com/installation/repositories"
  },
  "sender": {
    "login": "octocat",
    "id": 1,
    "avatar_url": "https://github.com/images/error/octocat_happy.gif",
    "gravatar_id": "",
    "url": "https://api.github.com/users/octocat",
    "html_url": "https://github.com/octocat",
    "followers_url": "https://api.github.com/users/octocat/followers",
    "following_url": "https://api.github.com/users/octocat/following{/other_user}",
    "gists_url": "https://api.github.com/users/octocat/gists{/gist_id}",
    "starred_url": "https://api.github.com/users/octocat/starred{/owner}{/repo}",
    "subscriptions_url": "https://api.github.com/users/octocat/subscriptions",
    "organizations_url": "https://api.github.com/users/octocat/orgs",
    "repos_url": "https://api.github.com/users/octocat/repos",
    "events_url": "https://api.github.com/users/octocat/events{/privacy}",
    "received_events_url": "https://api.github.com/users/octocat/received_events",
    "type": "User",
    "site_admin": false
  }
}

InstallationRepositoriesEvent

Triggered when a repository is added or removed from an installation.

Events API payload

Key Type Description
action string The action that was performed. Can be either "added" or "removed".
installation object The installation itself.
repository_selection string The choice of repositories the installation is on. Can be either "selected" or "all".
repositories_added array An array of repository objects, which were added to the installation.
repositories_removed array An array of repository objects, which were removed from the installation.

Webhook event name

installation_repositories

Webhook payload example

{
  "action": "removed",
  "installation": {
    "id": 2,
    "account": {
      "login": "octocat",
      "id": 1,
      "avatar_url": "https://github.com/images/error/octocat_happy.gif",
      "gravatar_id": "",
      "url": "https://api.github.com/users/octocat",
      "html_url": "https://github.com/octocat",
      "followers_url": "https://api.github.com/users/octocat/followers",
      "following_url": "https://api.github.com/users/octocat/following{/other_user}",
      "gists_url": "https://api.github.com/users/octocat/gists{/gist_id}",
      "starred_url": "https://api.github.com/users/octocat/starred{/owner}{/repo}",
      "subscriptions_url": "https://api.github.com/users/octocat/subscriptions",
      "organizations_url": "https://api.github.com/users/octocat/orgs",
      "repos_url": "https://api.github.com/users/octocat/repos",
      "events_url": "https://api.github.com/users/octocat/events{/privacy}",
      "received_events_url": "https://api.github.com/users/octocat/received_events",
      "type": "User",
      "site_admin": false
    },
    "repository_selection": "selected",
    "access_tokens_url": "https://api.github.com/installations/2/access_tokens",
    "repositories_url": "https://api.github.com/installation/repositories",
    "html_url": "https://github.com/settings/installations/2"
  },
  "repository_selection": "selected",
  "repositories_added": [

  ],
  "repositories_removed": [
    {
      "id": 1296269,
      "name": "Hello-World",
      "full_name": "octocat/Hello-World"
    }
  ],
  "sender": {
    "login": "octocat",
    "id": 1,
    "avatar_url": "https://github.com/images/error/octocat_happy.gif",
    "gravatar_id": "",
    "url": "https://api.github.com/users/octocat",
    "html_url": "https://github.com/octocat",
    "followers_url": "https://api.github.com/users/octocat/followers",
    "following_url": "https://api.github.com/users/octocat/following{/other_user}",
    "gists_url": "https://api.github.com/users/octocat/gists{/gist_id}",
    "starred_url": "https://api.github.com/users/octocat/starred{/owner}{/repo}",
    "subscriptions_url": "https://api.github.com/users/octocat/subscriptions",
    "organizations_url": "https://api.github.com/users/octocat/orgs",
    "repos_url": "https://api.github.com/users/octocat/repos",
    "events_url": "https://api.github.com/users/octocat/events{/privacy}",
    "received_events_url": "https://api.github.com/users/octocat/received_events",
    "type": "User",
    "site_admin": false
  }
}

IssueCommentEvent

Triggered when an issue comment is created, edited, or deleted.

Events API payload

Key Type Description
action string The action that was performed on the comment. Can be one of "created", "edited", or "deleted".
changes object The changes to the comment if the action was "edited".
changes[body][from] string The previous version of the body if the action was "edited".
issue object The issue the comment belongs to.
comment object The comment itself.

Webhook event name

issue_comment

Webhook payload example

{
  "action": "created",
  "issue": {
    "url": "https://api.github.com/repos/baxterthehacker/public-repo/issues/2",
    "labels_url": "https://api.github.com/repos/baxterthehacker/public-repo/issues/2/labels{/name}",
    "comments_url": "https://api.github.com/repos/baxterthehacker/public-repo/issues/2/comments",
    "events_url": "https://api.github.com/repos/baxterthehacker/public-repo/issues/2/events",
    "html_url": "https://github.com/baxterthehacker/public-repo/issues/2",
    "id": 73464126,
    "number": 2,
    "title": "Spelling error in the README file",
    "user": {
      "login": "baxterthehacker",
      "id": 6752317,
      "avatar_url": "https://avatars.githubusercontent.com/u/6752317?v=3",
      "gravatar_id": "",
      "url": "https://api.github.com/users/baxterthehacker",
      "html_url": "https://github.com/baxterthehacker",
      "followers_url": "https://api.github.com/users/baxterthehacker/followers",
      "following_url": "https://api.github.com/users/baxterthehacker/following{/other_user}",
      "gists_url": "https://api.github.com/users/baxterthehacker/gists{/gist_id}",
      "starred_url": "https://api.github.com/users/baxterthehacker/starred{/owner}{/repo}",
      "subscriptions_url": "https://api.github.com/users/baxterthehacker/subscriptions",
      "organizations_url": "https://api.github.com/users/baxterthehacker/orgs",
      "repos_url": "https://api.github.com/users/baxterthehacker/repos",
      "events_url": "https://api.github.com/users/baxterthehacker/events{/privacy}",
      "received_events_url": "https://api.github.com/users/baxterthehacker/received_events",
      "type": "User",
      "site_admin": false
    },
    "labels": [
      {
        "url": "https://api.github.com/repos/baxterthehacker/public-repo/labels/bug",
        "name": "bug",
        "color": "fc2929"
      }
    ],
    "state": "open",
    "locked": false,
    "assignee": null,
    "milestone": null,
    "comments": 1,
    "created_at": "2015-05-05T23:40:28Z",
    "updated_at": "2015-05-05T23:40:28Z",
    "closed_at": null,
    "body": "It looks like you accidently spelled 'commit' with two 't's."
  },
  "comment": {
    "url": "https://api.github.com/repos/baxterthehacker/public-repo/issues/comments/99262140",
    "html_url": "https://github.com/baxterthehacker/public-repo/issues/2#issuecomment-99262140",
    "issue_url": "https://api.github.com/repos/baxterthehacker/public-repo/issues/2",
    "id": 99262140,
    "user": {
      "login": "baxterthehacker",
      "id": 6752317,
      "avatar_url": "https://avatars.githubusercontent.com/u/6752317?v=3",
      "gravatar_id": "",
      "url": "https://api.github.com/users/baxterthehacker",
      "html_url": "https://github.com/baxterthehacker",
      "followers_url": "https://api.github.com/users/baxterthehacker/followers",
      "following_url": "https://api.github.com/users/baxterthehacker/following{/other_user}",
      "gists_url": "https://api.github.com/users/baxterthehacker/gists{/gist_id}",
      "starred_url": "https://api.github.com/users/baxterthehacker/starred{/owner}{/repo}",
      "subscriptions_url": "https://api.github.com/users/baxterthehacker/subscriptions",
      "organizations_url": "https://api.github.com/users/baxterthehacker/orgs",
      "repos_url": "https://api.github.com/users/baxterthehacker/repos",
      "events_url": "https://api.github.com/users/baxterthehacker/events{/privacy}",
      "received_events_url": "https://api.github.com/users/baxterthehacker/received_events",
      "type": "User",
      "site_admin": false
    },
    "created_at": "2015-05-05T23:40:28Z",
    "updated_at": "2015-05-05T23:40:28Z",
    "body": "You are totally right! I'll get this fixed right away."
  },
  "repository": {
    "id": 35129377,
    "name": "public-repo",
    "full_name": "baxterthehacker/public-repo",
    "owner": {
      "login": "baxterthehacker",
      "id": 6752317,
      "avatar_url": "https://avatars.githubusercontent.com/u/6752317?v=3",
      "gravatar_id": "",
      "url": "https://api.github.com/users/baxterthehacker",
      "html_url": "https://github.com/baxterthehacker",
      "followers_url": "https://api.github.com/users/baxterthehacker/followers",
      "following_url": "https://api.github.com/users/baxterthehacker/following{/other_user}",
      "gists_url": "https://api.github.com/users/baxterthehacker/gists{/gist_id}",
      "starred_url": "https://api.github.com/users/baxterthehacker/starred{/owner}{/repo}",
      "subscriptions_url": "https://api.github.com/users/baxterthehacker/subscriptions",
      "organizations_url": "https://api.github.com/users/baxterthehacker/orgs",
      "repos_url": "https://api.github.com/users/baxterthehacker/repos",
      "events_url": "https://api.github.com/users/baxterthehacker/events{/privacy}",
      "received_events_url": "https://api.github.com/users/baxterthehacker/received_events",
      "type": "User",
      "site_admin": false
    },
    "private": false,
    "html_url": "https://github.com/baxterthehacker/public-repo",
    "description": "",
    "fork": false,
    "url": "https://api.github.com/repos/baxterthehacker/public-repo",
    "forks_url": "https://api.github.com/repos/baxterthehacker/public-repo/forks",
    "keys_url": "https://api.github.com/repos/baxterthehacker/public-repo/keys{/key_id}",
    "collaborators_url": "https://api.github.com/repos/baxterthehacker/public-repo/collaborators{/collaborator}",
    "teams_url": "https://api.github.com/repos/baxterthehacker/public-repo/teams",
    "hooks_url": "https://api.github.com/repos/baxterthehacker/public-repo/hooks",
    "issue_events_url": "https://api.github.com/repos/baxterthehacker/public-repo/issues/events{/number}",
    "events_url": "https://api.github.com/repos/baxterthehacker/public-repo/events",
    "assignees_url": "https://api.github.com/repos/baxterthehacker/public-repo/assignees{/user}",
    "branches_url": "https://api.github.com/repos/baxterthehacker/public-repo/branches{/branch}",
    "tags_url": "https://api.github.com/repos/baxterthehacker/public-repo/tags",
    "blobs_url": "https://api.github.com/repos/baxterthehacker/public-repo/git/blobs{/sha}",
    "git_tags_url": "https://api.github.com/repos/baxterthehacker/public-repo/git/tags{/sha}",
    "git_refs_url": "https://api.github.com/repos/baxterthehacker/public-repo/git/refs{/sha}",
    "trees_url": "https://api.github.com/repos/baxterthehacker/public-repo/git/trees{/sha}",
    "statuses_url": "https://api.github.com/repos/baxterthehacker/public-repo/statuses/{sha}",
    "languages_url": "https://api.github.com/repos/baxterthehacker/public-repo/languages",
    "stargazers_url": "https://api.github.com/repos/baxterthehacker/public-repo/stargazers",
    "contributors_url": "https://api.github.com/repos/baxterthehacker/public-repo/contributors",
    "subscribers_url": "https://api.github.com/repos/baxterthehacker/public-repo/subscribers",
    "subscription_url": "https://api.github.com/repos/baxterthehacker/public-repo/subscription",
    "commits_url": "https://api.github.com/repos/baxterthehacker/public-repo/commits{/sha}",
    "git_commits_url": "https://api.github.com/repos/baxterthehacker/public-repo/git/commits{/sha}",
    "comments_url": "https://api.github.com/repos/baxterthehacker/public-repo/comments{/number}",
    "issue_comment_url": "https://api.github.com/repos/baxterthehacker/public-repo/issues/comments{/number}",
    "contents_url": "https://api.github.com/repos/baxterthehacker/public-repo/contents/{+path}",
    "compare_url": "https://api.github.com/repos/baxterthehacker/public-repo/compare/{base}...{head}",
    "merges_url": "https://api.github.com/repos/baxterthehacker/public-repo/merges",
    "archive_url": "https://api.github.com/repos/baxterthehacker/public-repo/{archive_format}{/ref}",
    "downloads_url": "https://api.github.com/repos/baxterthehacker/public-repo/downloads",
    "issues_url": "https://api.github.com/repos/baxterthehacker/public-repo/issues{/number}",
    "pulls_url": "https://api.github.com/repos/baxterthehacker/public-repo/pulls{/number}",
    "milestones_url": "https://api.github.com/repos/baxterthehacker/public-repo/milestones{/number}",
    "notifications_url": "https://api.github.com/repos/baxterthehacker/public-repo/notifications{?since,all,participating}",
    "labels_url": "https://api.github.com/repos/baxterthehacker/public-repo/labels{/name}",
    "releases_url": "https://api.github.com/repos/baxterthehacker/public-repo/releases{/id}",
    "created_at": "2015-05-05T23:40:12Z",
    "updated_at": "2015-05-05T23:40:12Z",
    "pushed_at": "2015-05-05T23:40:27Z",
    "git_url": "git://github.com/baxterthehacker/public-repo.git",
    "ssh_url": "git@github.com:baxterthehacker/public-repo.git",
    "clone_url": "https://github.com/baxterthehacker/public-repo.git",
    "svn_url": "https://github.com/baxterthehacker/public-repo",
    "homepage": null,
    "size": 0,
    "stargazers_count": 0,
    "watchers_count": 0,
    "language": null,
    "has_issues": true,
    "has_downloads": true,
    "has_wiki": true,
    "has_pages": true,
    "forks_count": 0,
    "mirror_url": null,
    "open_issues_count": 2,
    "forks": 0,
    "open_issues": 2,
    "watchers": 0,
    "default_branch": "master"
  },
  "sender": {
    "login": "baxterthehacker",
    "id": 6752317,
    "avatar_url": "https://avatars.githubusercontent.com/u/6752317?v=3",
    "gravatar_id": "",
    "url": "https://api.github.com/users/baxterthehacker",
    "html_url": "https://github.com/baxterthehacker",
    "followers_url": "https://api.github.com/users/baxterthehacker/followers",
    "following_url": "https://api.github.com/users/baxterthehacker/following{/other_user}",
    "gists_url": "https://api.github.com/users/baxterthehacker/gists{/gist_id}",
    "starred_url": "https://api.github.com/users/baxterthehacker/starred{/owner}{/repo}",
    "subscriptions_url": "https://api.github.com/users/baxterthehacker/subscriptions",
    "organizations_url": "https://api.github.com/users/baxterthehacker/orgs",
    "repos_url": "https://api.github.com/users/baxterthehacker/repos",
    "events_url": "https://api.github.com/users/baxterthehacker/events{/privacy}",
    "received_events_url": "https://api.github.com/users/baxterthehacker/received_events",
    "type": "User",
    "site_admin": false
  }
}

IssuesEvent

Triggered when an issue is assigned, unassigned, labeled, unlabeled, opened, edited, milestoned, demilestoned, closed, or reopened.

Events API payload

Key Type Description
action string The action that was performed. Can be one of "assigned", "unassigned", "labeled", "unlabeled", "opened", "edited", "milestoned", "demilestoned", "closed", or "reopened".
issue object The issue itself.
changes object The changes to the issue if the action was "edited".
changes[title][from] string The previous version of the title if the action was "edited".
changes[body][from] string The previous version of the body if the action was "edited".
assignee object The optional user who was assigned or unassigned from the issue.
label object The optional label that was added or removed from the issue.

Webhook event name

issues

Webhook payload example

{
  "action": "opened",
  "issue": {
    "url": "https://api.github.com/repos/baxterthehacker/public-repo/issues/2",
    "labels_url": "https://api.github.com/repos/baxterthehacker/public-repo/issues/2/labels{/name}",
    "comments_url": "https://api.github.com/repos/baxterthehacker/public-repo/issues/2/comments",
    "events_url": "https://api.github.com/repos/baxterthehacker/public-repo/issues/2/events",
    "html_url": "https://github.com/baxterthehacker/public-repo/issues/2",
    "id": 73464126,
    "number": 2,
    "title": "Spelling error in the README file",
    "user": {
      "login": "baxterthehacker",
      "id": 6752317,
      "avatar_url": "https://avatars.githubusercontent.com/u/6752317?v=3",
      "gravatar_id": "",
      "url": "https://api.github.com/users/baxterthehacker",
      "html_url": "https://github.com/baxterthehacker",
      "followers_url": "https://api.github.com/users/baxterthehacker/followers",
      "following_url": "https://api.github.com/users/baxterthehacker/following{/other_user}",
      "gists_url": "https://api.github.com/users/baxterthehacker/gists{/gist_id}",
      "starred_url": "https://api.github.com/users/baxterthehacker/starred{/owner}{/repo}",
      "subscriptions_url": "https://api.github.com/users/baxterthehacker/subscriptions",
      "organizations_url": "https://api.github.com/users/baxterthehacker/orgs",
      "repos_url": "https://api.github.com/users/baxterthehacker/repos",
      "events_url": "https://api.github.com/users/baxterthehacker/events{/privacy}",
      "received_events_url": "https://api.github.com/users/baxterthehacker/received_events",
      "type": "User",
      "site_admin": false
    },
    "labels": [
      {
        "id": 208045946,
        "url": "https://api.github.com/repos/baxterthehacker/public-repo/labels/bug",
        "name": "bug",
        "color": "fc2929",
        "default": true
      }
    ],
    "state": "open",
    "locked": false,
    "assignee": null,
    "milestone": null,
    "comments": 0,
    "created_at": "2015-05-05T23:40:28Z",
    "updated_at": "2015-05-05T23:40:28Z",
    "closed_at": null,
    "body": "It looks like you accidently spelled 'commit' with two 't's."
  },
  "repository": {
    "id": 35129377,
    "name": "public-repo",
    "full_name": "baxterthehacker/public-repo",
    "owner": {
      "login": "baxterthehacker",
      "id": 6752317,
      "avatar_url": "https://avatars.githubusercontent.com/u/6752317?v=3",
      "gravatar_id": "",
      "url": "https://api.github.com/users/baxterthehacker",
      "html_url": "https://github.com/baxterthehacker",
      "followers_url": "https://api.github.com/users/baxterthehacker/followers",
      "following_url": "https://api.github.com/users/baxterthehacker/following{/other_user}",
      "gists_url": "https://api.github.com/users/baxterthehacker/gists{/gist_id}",
      "starred_url": "https://api.github.com/users/baxterthehacker/starred{/owner}{/repo}",
      "subscriptions_url": "https://api.github.com/users/baxterthehacker/subscriptions",
      "organizations_url": "https://api.github.com/users/baxterthehacker/orgs",
      "repos_url": "https://api.github.com/users/baxterthehacker/repos",
      "events_url": "https://api.github.com/users/baxterthehacker/events{/privacy}",
      "received_events_url": "https://api.github.com/users/baxterthehacker/received_events",
      "type": "User",
      "site_admin": false
    },
    "private": false,
    "html_url": "https://github.com/baxterthehacker/public-repo",
    "description": "",
    "fork": false,
    "url": "https://api.github.com/repos/baxterthehacker/public-repo",
    "forks_url": "https://api.github.com/repos/baxterthehacker/public-repo/forks",
    "keys_url": "https://api.github.com/repos/baxterthehacker/public-repo/keys{/key_id}",
    "collaborators_url": "https://api.github.com/repos/baxterthehacker/public-repo/collaborators{/collaborator}",
    "teams_url": "https://api.github.com/repos/baxterthehacker/public-repo/teams",
    "hooks_url": "https://api.github.com/repos/baxterthehacker/public-repo/hooks",
    "issue_events_url": "https://api.github.com/repos/baxterthehacker/public-repo/issues/events{/number}",
    "events_url": "https://api.github.com/repos/baxterthehacker/public-repo/events",
    "assignees_url": "https://api.github.com/repos/baxterthehacker/public-repo/assignees{/user}",
    "branches_url": "https://api.github.com/repos/baxterthehacker/public-repo/branches{/branch}",
    "tags_url": "https://api.github.com/repos/baxterthehacker/public-repo/tags",
    "blobs_url": "https://api.github.com/repos/baxterthehacker/public-repo/git/blobs{/sha}",
    "git_tags_url": "https://api.github.com/repos/baxterthehacker/public-repo/git/tags{/sha}",
    "git_refs_url": "https://api.github.com/repos/baxterthehacker/public-repo/git/refs{/sha}",
    "trees_url": "https://api.github.com/repos/baxterthehacker/public-repo/git/trees{/sha}",
    "statuses_url": "https://api.github.com/repos/baxterthehacker/public-repo/statuses/{sha}",
    "languages_url": "https://api.github.com/repos/baxterthehacker/public-repo/languages",
    "stargazers_url": "https://api.github.com/repos/baxterthehacker/public-repo/stargazers",
    "contributors_url": "https://api.github.com/repos/baxterthehacker/public-repo/contributors",
    "subscribers_url": "https://api.github.com/repos/baxterthehacker/public-repo/subscribers",
    "subscription_url": "https://api.github.com/repos/baxterthehacker/public-repo/subscription",
    "commits_url": "https://api.github.com/repos/baxterthehacker/public-repo/commits{/sha}",
    "git_commits_url": "https://api.github.com/repos/baxterthehacker/public-repo/git/commits{/sha}",
    "comments_url": "https://api.github.com/repos/baxterthehacker/public-repo/comments{/number}",
    "issue_comment_url": "https://api.github.com/repos/baxterthehacker/public-repo/issues/comments{/number}",
    "contents_url": "https://api.github.com/repos/baxterthehacker/public-repo/contents/{+path}",
    "compare_url": "https://api.github.com/repos/baxterthehacker/public-repo/compare/{base}...{head}",
    "merges_url": "https://api.github.com/repos/baxterthehacker/public-repo/merges",
    "archive_url": "https://api.github.com/repos/baxterthehacker/public-repo/{archive_format}{/ref}",
    "downloads_url": "https://api.github.com/repos/baxterthehacker/public-repo/downloads",
    "issues_url": "https://api.github.com/repos/baxterthehacker/public-repo/issues{/number}",
    "pulls_url": "https://api.github.com/repos/baxterthehacker/public-repo/pulls{/number}",
    "milestones_url": "https://api.github.com/repos/baxterthehacker/public-repo/milestones{/number}",
    "notifications_url": "https://api.github.com/repos/baxterthehacker/public-repo/notifications{?since,all,participating}",
    "labels_url": "https://api.github.com/repos/baxterthehacker/public-repo/labels{/name}",
    "releases_url": "https://api.github.com/repos/baxterthehacker/public-repo/releases{/id}",
    "created_at": "2015-05-05T23:40:12Z",
    "updated_at": "2015-05-05T23:40:12Z",
    "pushed_at": "2015-05-05T23:40:27Z",
    "git_url": "git://github.com/baxterthehacker/public-repo.git",
    "ssh_url": "git@github.com:baxterthehacker/public-repo.git",
    "clone_url": "https://github.com/baxterthehacker/public-repo.git",
    "svn_url": "https://github.com/baxterthehacker/public-repo",
    "homepage": null,
    "size": 0,
    "stargazers_count": 0,
    "watchers_count": 0,
    "language": null,
    "has_issues": true,
    "has_downloads": true,
    "has_wiki": true,
    "has_pages": true,
    "forks_count": 0,
    "mirror_url": null,
    "open_issues_count": 2,
    "forks": 0,
    "open_issues": 2,
    "watchers": 0,
    "default_branch": "master"
  },
  "sender": {
    "login": "baxterthehacker",
    "id": 6752317,
    "avatar_url": "https://avatars.githubusercontent.com/u/6752317?v=3",
    "gravatar_id": "",
    "url": "https://api.github.com/users/baxterthehacker",
    "html_url": "https://github.com/baxterthehacker",
    "followers_url": "https://api.github.com/users/baxterthehacker/followers",
    "following_url": "https://api.github.com/users/baxterthehacker/following{/other_user}",
    "gists_url": "https://api.github.com/users/baxterthehacker/gists{/gist_id}",
    "starred_url": "https://api.github.com/users/baxterthehacker/starred{/owner}{/repo}",
    "subscriptions_url": "https://api.github.com/users/baxterthehacker/subscriptions",
    "organizations_url": "https://api.github.com/users/baxterthehacker/orgs",
    "repos_url": "https://api.github.com/users/baxterthehacker/repos",
    "events_url": "https://api.github.com/users/baxterthehacker/events{/privacy}",
    "received_events_url": "https://api.github.com/users/baxterthehacker/received_events",
    "type": "User",
    "site_admin": false
  }
}

LabelEvent

Triggered when a repository's label is created, edited, or deleted.

Events of this type are not visible in timelines. These events are only used to trigger hooks.

Events API Payload

Key Type Description
action string The action that was performed. Can be "created", "edited", or "deleted".
label object The label that was added.
changes object The changes to the label if the action was "edited".
changes[name][from] string The previous version of the name if the action was "edited".
changes[color][from] string The previous version of the color if the action was "edited".

Webhook event name

label

Webhook payload example

{
  "action":"created",
  "label":{
    "url":"https://api.github.com/repos/baxterandthehackers/public-repo/labels/blocked",
    "name":"blocked",
    "color":"ff0000"
  },
  "repository":{
    "id":67075329,
    "name":"public-repo",
    "full_name":"baxterandthehackers/public-repo",
    "owner":{
      "login":"baxterandthehackers",
      "id":4312013,
      "avatar_url":"https://avatars.githubusercontent.com/u/4312013?v=3",
      "gravatar_id":"",
      "url":"https://api.github.com/users/baxterandthehackers",
      "html_url":"https://github.com/baxterandthehackers",
      "followers_url":"https://api.github.com/users/baxterandthehackers/followers",
      "following_url":"https://api.github.com/users/baxterandthehackers/following{/other_user}",
      "gists_url":"https://api.github.com/users/baxterandthehackers/gists{/gist_id}",
      "starred_url":"https://api.github.com/users/baxterandthehackers/starred{/owner}{/repo}",
      "subscriptions_url":"https://api.github.com/users/baxterandthehackers/subscriptions",
      "organizations_url":"https://api.github.com/users/baxterandthehackers/orgs",
      "repos_url":"https://api.github.com/users/baxterandthehackers/repos",
      "events_url":"https://api.github.com/users/baxterandthehackers/events{/privacy}",
      "received_events_url":"https://api.github.com/users/baxterandthehackers/received_events",
      "type":"Organization",
      "site_admin":false
    },
    "private":true,
    "html_url":"https://github.com/baxterandthehackers/public-repo",
    "description":null,
    "fork":false,
    "url":"https://api.github.com/repos/baxterandthehackers/public-repo",
    "forks_url":"https://api.github.com/repos/baxterandthehackers/public-repo/forks",
    "keys_url":"https://api.github.com/repos/baxterandthehackers/public-repo/keys{/key_id}",
    "collaborators_url":"https://api.github.com/repos/baxterandthehackers/public-repo/collaborators{/collaborator}",
    "teams_url":"https://api.github.com/repos/baxterandthehackers/public-repo/teams",
    "hooks_url":"https://api.github.com/repos/baxterandthehackers/public-repo/hooks",
    "issue_events_url":"https://api.github.com/repos/baxterandthehackers/public-repo/issues/events{/number}",
    "events_url":"https://api.github.com/repos/baxterandthehackers/public-repo/events",
    "assignees_url":"https://api.github.com/repos/baxterandthehackers/public-repo/assignees{/user}",
    "branches_url":"https://api.github.com/repos/baxterandthehackers/public-repo/branches{/branch}",
    "tags_url":"https://api.github.com/repos/baxterandthehackers/public-repo/tags",
    "blobs_url":"https://api.github.com/repos/baxterandthehackers/public-repo/git/blobs{/sha}",
    "git_tags_url":"https://api.github.com/repos/baxterandthehackers/public-repo/git/tags{/sha}",
    "git_refs_url":"https://api.github.com/repos/baxterandthehackers/public-repo/git/refs{/sha}",
    "trees_url":"https://api.github.com/repos/baxterandthehackers/public-repo/git/trees{/sha}",
    "statuses_url":"https://api.github.com/repos/baxterandthehackers/public-repo/statuses/{sha}",
    "languages_url":"https://api.github.com/repos/baxterandthehackers/public-repo/languages",
    "stargazers_url":"https://api.github.com/repos/baxterandthehackers/public-repo/stargazers",
    "contributors_url":"https://api.github.com/repos/baxterandthehackers/public-repo/contributors",
    "subscribers_url":"https://api.github.com/repos/baxterandthehackers/public-repo/subscribers",
    "subscription_url":"https://api.github.com/repos/baxterandthehackers/public-repo/subscription",
    "commits_url":"https://api.github.com/repos/baxterandthehackers/public-repo/commits{/sha}",
    "git_commits_url":"https://api.github.com/repos/baxterandthehackers/public-repo/git/commits{/sha}",
    "comments_url":"https://api.github.com/repos/baxterandthehackers/public-repo/comments{/number}",
    "issue_comment_url":"https://api.github.com/repos/baxterandthehackers/public-repo/issues/comments{/number}",
    "contents_url":"https://api.github.com/repos/baxterandthehackers/public-repo/contents/{+path}",
    "compare_url":"https://api.github.com/repos/baxterandthehackers/public-repo/compare/{base}...{head}",
    "merges_url":"https://api.github.com/repos/baxterandthehackers/public-repo/merges",
    "archive_url":"https://api.github.com/repos/baxterandthehackers/public-repo/{archive_format}{/ref}",
    "downloads_url":"https://api.github.com/repos/baxterandthehackers/public-repo/downloads",
    "issues_url":"https://api.github.com/repos/baxterandthehackers/public-repo/issues{/number}",
    "pulls_url":"https://api.github.com/repos/baxterandthehackers/public-repo/pulls{/number}",
    "milestones_url":"https://api.github.com/repos/baxterandthehackers/public-repo/milestones{/number}",
    "notifications_url":"https://api.github.com/repos/baxterandthehackers/public-repo/notifications{?since,all,participating}",
    "labels_url":"https://api.github.com/repos/baxterandthehackers/public-repo/labels{/name}",
    "releases_url":"https://api.github.com/repos/baxterandthehackers/public-repo/releases{/id}",
    "deployments_url":"https://api.github.com/repos/baxterandthehackers/public-repo/deployments",
    "created_at":"2016-08-31T21:38:51Z",
    "updated_at":"2016-08-31T21:38:51Z",
    "pushed_at":"2016-08-31T21:38:51Z",
    "git_url":"git://github.com/baxterandthehackers/public-repo.git",
    "ssh_url":"git@github.com:baxterandthehackers/public-repo.git",
    "clone_url":"https://github.com/baxterandthehackers/public-repo.git",
    "svn_url":"https://github.com/baxterandthehackers/public-repo",
    "homepage":null,
    "size":0,
    "stargazers_count":0,
    "watchers_count":0,
    "language":null,
    "has_issues":true,
    "has_downloads":true,
    "has_wiki":true,
    "has_pages":false,
    "forks_count":0,
    "mirror_url":null,
    "open_issues_count":2,
    "forks":0,
    "open_issues":2,
    "watchers":0,
    "default_branch":"master"
  },
  "organization":{
    "login":"baxterandthehackers",
    "id":4312013,
    "url":"https://api.github.com/orgs/baxterandthehackers",
    "repos_url":"https://api.github.com/orgs/baxterandthehackers/repos",
    "events_url":"https://api.github.com/orgs/baxterandthehackers/events",
    "hooks_url":"https://api.github.com/orgs/baxterandthehackers/hooks",
    "issues_url":"https://api.github.com/orgs/baxterandthehackers/issues",
    "members_url":"https://api.github.com/orgs/baxterandthehackers/members{/member}",
    "public_members_url":"https://api.github.com/orgs/baxterandthehackers/public_members{/member}",
    "avatar_url":"https://avatars.githubusercontent.com/u/4312013?v=3",
    "description":""
  },
  "sender":{
    "login":"baxterthehacker",
    "id":7649605,
    "avatar_url":"https://avatars.githubusercontent.com/u/7649605?v=3",
    "gravatar_id":"",
    "url":"https://api.github.com/users/baxterthehacker",
    "html_url":"https://github.com/baxterthehacker",
    "followers_url":"https://api.github.com/users/baxterthehacker/followers",
    "following_url":"https://api.github.com/users/baxterthehacker/following{/other_user}",
    "gists_url":"https://api.github.com/users/baxterthehacker/gists{/gist_id}",
    "starred_url":"https://api.github.com/users/baxterthehacker/starred{/owner}{/repo}",
    "subscriptions_url":"https://api.github.com/users/baxterthehacker/subscriptions",
    "organizations_url":"https://api.github.com/users/baxterthehacker/orgs",
    "repos_url":"https://api.github.com/users/baxterthehacker/repos",
    "events_url":"https://api.github.com/users/baxterthehacker/events{/privacy}",
    "received_events_url":"https://api.github.com/users/baxterthehacker/received_events",
    "type":"User",
    "site_admin":true
  }
}

MarketplacePurchaseEvent

Triggered when a user purchases, cancels, or changes their GitHub Marketplace plan.

Events API payload

Key Type Description
action string The action performed. Can be "purchased", "cancelled", or "changed".

Webhook event name

marketplace_purchase

Webhook payload example

{
  "action": "changed",
  "effective_date": "2017-04-06T02:01:16Z",
  "marketplace_purchase": {
    "account": {
      "type": "Organization",
      "id": 4,
      "login": "GitHub",
      "organization_billing_email": "billing@github.com"
    },
    "billing_cycle": "monthly",
    "next_billing_date": "2017-05-01T00:00:00Z",
    "unit_count": 1,
    "on_free_trial": true,
    "free_trial_ends_on": "2017-11-11T00:00:00Z",
    "plan": {
      "id": 9,
      "name": "Super Pro",
      "description": "A really, super professional-grade CI solution",
      "monthly_price_in_cents": 9999,
      "yearly_price_in_cents": 11998,
      "price_model": "flat-rate",
      "has_free_trial": true,
      "unit_name": null,
      "bullets": [
        "This is the first bullet of the plan",
        "This is the second bullet of the plan"
      ]
    }
  },
  "previous_marketplace_purchase": {
    "account": {
      "type": "Organization",
      "id": 4,
      "login": "GitHub",
      "organization_billing_email": "billing@github.com"
    },
    "billing_cycle": "monthly",
    "next_billing_date": "2017-05-01T00:00:00Z",
    "unit_count": 1,
    "on_free_trial": false,
    "free_trial_ends_on": null,
    "plan": {
      "id": 9,
      "name": "Super Pro",
      "description": "A really, super professional-grade CI solution",
      "monthly_price_in_cents": 9999,
      "yearly_price_in_cents": 11998,
      "price_model": "flat-rate",
      "has_free_trial": true,
      "unit_name": null,
      "bullets": [
        "This is the first bullet of the plan",
        "This is the second bullet of the plan"
      ]
    }
  },
  "sender": {
    "id": 1,
    "login": "octocat",
    "email": "octocat@github.com"
  }
}

MemberEvent

Triggered when a user is added or removed as a collaborator to a repository, or has their permissions changed.

Events API payload

Key Type Description
member object The user that was added.
action string The action that was performed. Can be one of added, deleted, or edited.
changes object The changes to the collaborator permissions if the action was edited.
changes[old_permission][from] string The previous permissions of the collaborator if the action was edited.

Webhook event name

member

Webhook payload example

{
  "action": "added",
  "member": {
    "login": "octocat",
    "id": 583231,
    "avatar_url": "https://avatars.githubusercontent.com/u/583231?v=3",
    "gravatar_id": "",
    "url": "https://api.github.com/users/octocat",
    "html_url": "https://github.com/octocat",
    "followers_url": "https://api.github.com/users/octocat/followers",
    "following_url": "https://api.github.com/users/octocat/following{/other_user}",
    "gists_url": "https://api.github.com/users/octocat/gists{/gist_id}",
    "starred_url": "https://api.github.com/users/octocat/starred{/owner}{/repo}",
    "subscriptions_url": "https://api.github.com/users/octocat/subscriptions",
    "organizations_url": "https://api.github.com/users/octocat/orgs",
    "repos_url": "https://api.github.com/users/octocat/repos",
    "events_url": "https://api.github.com/users/octocat/events{/privacy}",
    "received_events_url": "https://api.github.com/users/octocat/received_events",
    "type": "User",
    "site_admin": false
  },
  "repository": {
    "id": 35129377,
    "name": "public-repo",
    "full_name": "baxterthehacker/public-repo",
    "owner": {
      "login": "baxterthehacker",
      "id": 6752317,
      "avatar_url": "https://avatars.githubusercontent.com/u/6752317?v=3",
      "gravatar_id": "",
      "url": "https://api.github.com/users/baxterthehacker",
      "html_url": "https://github.com/baxterthehacker",
      "followers_url": "https://api.github.com/users/baxterthehacker/followers",
      "following_url": "https://api.github.com/users/baxterthehacker/following{/other_user}",
      "gists_url": "https://api.github.com/users/baxterthehacker/gists{/gist_id}",
      "starred_url": "https://api.github.com/users/baxterthehacker/starred{/owner}{/repo}",
      "subscriptions_url": "https://api.github.com/users/baxterthehacker/subscriptions",
      "organizations_url": "https://api.github.com/users/baxterthehacker/orgs",
      "repos_url": "https://api.github.com/users/baxterthehacker/repos",
      "events_url": "https://api.github.com/users/baxterthehacker/events{/privacy}",
      "received_events_url": "https://api.github.com/users/baxterthehacker/received_events",
      "type": "User",
      "site_admin": false
    },
    "private": false,
    "html_url": "https://github.com/baxterthehacker/public-repo",
    "description": "",
    "fork": false,
    "url": "https://api.github.com/repos/baxterthehacker/public-repo",
    "forks_url": "https://api.github.com/repos/baxterthehacker/public-repo/forks",
    "keys_url": "https://api.github.com/repos/baxterthehacker/public-repo/keys{/key_id}",
    "collaborators_url": "https://api.github.com/repos/baxterthehacker/public-repo/collaborators{/collaborator}",
    "teams_url": "https://api.github.com/repos/baxterthehacker/public-repo/teams",
    "hooks_url": "https://api.github.com/repos/baxterthehacker/public-repo/hooks",
    "issue_events_url": "https://api.github.com/repos/baxterthehacker/public-repo/issues/events{/number}",
    "events_url": "https://api.github.com/repos/baxterthehacker/public-repo/events",
    "assignees_url": "https://api.github.com/repos/baxterthehacker/public-repo/assignees{/user}",
    "branches_url": "https://api.github.com/repos/baxterthehacker/public-repo/branches{/branch}",
    "tags_url": "https://api.github.com/repos/baxterthehacker/public-repo/tags",
    "blobs_url": "https://api.github.com/repos/baxterthehacker/public-repo/git/blobs{/sha}",
    "git_tags_url": "https://api.github.com/repos/baxterthehacker/public-repo/git/tags{/sha}",
    "git_refs_url": "https://api.github.com/repos/baxterthehacker/public-repo/git/refs{/sha}",
    "trees_url": "https://api.github.com/repos/baxterthehacker/public-repo/git/trees{/sha}",
    "statuses_url": "https://api.github.com/repos/baxterthehacker/public-repo/statuses/{sha}",
    "languages_url": "https://api.github.com/repos/baxterthehacker/public-repo/languages",
    "stargazers_url": "https://api.github.com/repos/baxterthehacker/public-repo/stargazers",
    "contributors_url": "https://api.github.com/repos/baxterthehacker/public-repo/contributors",
    "subscribers_url": "https://api.github.com/repos/baxterthehacker/public-repo/subscribers",
    "subscription_url": "https://api.github.com/repos/baxterthehacker/public-repo/subscription",
    "commits_url": "https://api.github.com/repos/baxterthehacker/public-repo/commits{/sha}",
    "git_commits_url": "https://api.github.com/repos/baxterthehacker/public-repo/git/commits{/sha}",
    "comments_url": "https://api.github.com/repos/baxterthehacker/public-repo/comments{/number}",
    "issue_comment_url": "https://api.github.com/repos/baxterthehacker/public-repo/issues/comments{/number}",
    "contents_url": "https://api.github.com/repos/baxterthehacker/public-repo/contents/{+path}",
    "compare_url": "https://api.github.com/repos/baxterthehacker/public-repo/compare/{base}...{head}",
    "merges_url": "https://api.github.com/repos/baxterthehacker/public-repo/merges",
    "archive_url": "https://api.github.com/repos/baxterthehacker/public-repo/{archive_format}{/ref}",
    "downloads_url": "https://api.github.com/repos/baxterthehacker/public-repo/downloads",
    "issues_url": "https://api.github.com/repos/baxterthehacker/public-repo/issues{/number}",
    "pulls_url": "https://api.github.com/repos/baxterthehacker/public-repo/pulls{/number}",
    "milestones_url": "https://api.github.com/repos/baxterthehacker/public-repo/milestones{/number}",
    "notifications_url": "https://api.github.com/repos/baxterthehacker/public-repo/notifications{?since,all,participating}",
    "labels_url": "https://api.github.com/repos/baxterthehacker/public-repo/labels{/name}",
    "releases_url": "https://api.github.com/repos/baxterthehacker/public-repo/releases{/id}",
    "created_at": "2015-05-05T23:40:12Z",
    "updated_at": "2015-05-05T23:40:30Z",
    "pushed_at": "2015-05-05T23:40:40Z",
    "git_url": "git://github.com/baxterthehacker/public-repo.git",
    "ssh_url": "git@github.com:baxterthehacker/public-repo.git",
    "clone_url": "https://github.com/baxterthehacker/public-repo.git",
    "svn_url": "https://github.com/baxterthehacker/public-repo",
    "homepage": null,
    "size": 0,
    "stargazers_count": 0,
    "watchers_count": 0,
    "language": null,
    "has_issues": true,
    "has_downloads": true,
    "has_wiki": true,
    "has_pages": true,
    "forks_count": 0,
    "mirror_url": null,
    "open_issues_count": 2,
    "forks": 0,
    "open_issues": 2,
    "watchers": 0,
    "default_branch": "master"
  },
  "sender": {
    "login": "baxterthehacker",
    "id": 6752317,
    "avatar_url": "https://avatars.githubusercontent.com/u/6752317?v=3",
    "gravatar_id": "",
    "url": "https://api.github.com/users/baxterthehacker",
    "html_url": "https://github.com/baxterthehacker",
    "followers_url": "https://api.github.com/users/baxterthehacker/followers",
    "following_url": "https://api.github.com/users/baxterthehacker/following{/other_user}",
    "gists_url": "https://api.github.com/users/baxterthehacker/gists{/gist_id}",
    "starred_url": "https://api.github.com/users/baxterthehacker/starred{/owner}{/repo}",
    "subscriptions_url": "https://api.github.com/users/baxterthehacker/subscriptions",
    "organizations_url": "https://api.github.com/users/baxterthehacker/orgs",
    "repos_url": "https://api.github.com/users/baxterthehacker/repos",
    "events_url": "https://api.github.com/users/baxterthehacker/events{/privacy}",
    "received_events_url": "https://api.github.com/users/baxterthehacker/received_events",
    "type": "User",
    "site_admin": false
  }
}

MembershipEvent

Triggered when a user is added or removed from a team.

Events of this type are not visible in timelines. These events are only used to trigger hooks.

Events API payload

Key Type Description
action string The action that was performed. Can be "added" or "removed".
scope string The scope of the membership. Currently, can only be "team".
member object The user that was added or removed.
team object The team for the membership.

Webhook event name

membership

Webhook payload example

{
  "action": "added",
  "scope": "team",
  "member": {
    "login": "kdaigle",
    "id": 2501,
    "avatar_url": "https://avatars.githubusercontent.com/u/2501?v=3",
    "gravatar_id": "",
    "url": "https://api.github.com/users/kdaigle",
    "html_url": "https://github.com/kdaigle",
    "followers_url": "https://api.github.com/users/kdaigle/followers",
    "following_url": "https://api.github.com/users/kdaigle/following{/other_user}",
    "gists_url": "https://api.github.com/users/kdaigle/gists{/gist_id}",
    "starred_url": "https://api.github.com/users/kdaigle/starred{/owner}{/repo}",
    "subscriptions_url": "https://api.github.com/users/kdaigle/subscriptions",
    "organizations_url": "https://api.github.com/users/kdaigle/orgs",
    "repos_url": "https://api.github.com/users/kdaigle/repos",
    "events_url": "https://api.github.com/users/kdaigle/events{/privacy}",
    "received_events_url": "https://api.github.com/users/kdaigle/received_events",
    "type": "User",
    "site_admin": true
  },
  "sender": {
    "login": "baxterthehacker",
    "id": 6752317,
    "avatar_url": "https://avatars.githubusercontent.com/u/6752317?v=2",
    "gravatar_id": "",
    "url": "https://api.github.com/users/baxterthehacker",
    "html_url": "https://github.com/baxterthehacker",
    "followers_url": "https://api.github.com/users/baxterthehacker/followers",
    "following_url": "https://api.github.com/users/baxterthehacker/following{/other_user}",
    "gists_url": "https://api.github.com/users/baxterthehacker/gists{/gist_id}",
    "starred_url": "https://api.github.com/users/baxterthehacker/starred{/owner}{/repo}",
    "subscriptions_url": "https://api.github.com/users/baxterthehacker/subscriptions",
    "organizations_url": "https://api.github.com/users/baxterthehacker/orgs",
    "repos_url": "https://api.github.com/users/baxterthehacker/repos",
    "events_url": "https://api.github.com/users/baxterthehacker/events{/privacy}",
    "received_events_url": "https://api.github.com/users/baxterthehacker/received_events",
    "type": "User",
    "site_admin": false
  },
  "team": {
    "name": "Contractors",
    "id": 123456,
    "slug": "contractors",
    "permission": "admin",
    "url": "https://api.github.com/teams/123456",
    "members_url": "https://api.github.com/teams/123456/members{/member}",
    "repositories_url": "https://api.github.com/teams/123456/repos"
  },
  "organization": {
    "login": "baxterandthehackers",
    "id": 7649605,
    "url": "https://api.github.com/orgs/baxterandthehackers",
    "repos_url": "https://api.github.com/orgs/baxterandthehackers/repos",
    "events_url": "https://api.github.com/orgs/baxterandthehackers/events",
    "members_url": "https://api.github.com/orgs/baxterandthehackers/members{/member}",
    "public_members_url": "https://api.github.com/orgs/baxterandthehackers/public_members{/member}",
    "avatar_url": "https://avatars.githubusercontent.com/u/7649605?v=2"
  }
}

MilestoneEvent

Triggered when a milestone is created, closed, opened, edited, or deleted.

Events of this type are not visible in timelines. These events are only used to trigger hooks.

Events API payload

Key Type Description
action string The action that was performed. Can be one of created, closed, opened, edited, or deleted.
milestone object The milestone itself.
changes object The changes to the milestone if the action was edited.
changes[description][from] string The previous version of the description if the action was edited.
changes[due_on][from] string The previous version of the due date if the action was edited.
changes[title][from] string The previous version of the title if the action was edited.

Webhook event name

milestone

Webhook payload example

{
  "action":"created",
  "milestone":{
    "url":"https://api.github.com/repos/baxterandthehackers/public-repo/milestones/3",
    "html_url":"https://github.com/baxterandthehackers/public-repo/milestones/Test%20milestone%20creation%20webhook%20from%20command%20line2",
    "labels_url":"https://api.github.com/repos/baxterandthehackers/public-repo/milestones/3/labels",
    "id":2055681,
    "number":3,
    "title":"I am a milestone",
    "description":null,
    "creator":{
      "login":"baxterthehacker",
      "id":7649605,
      "avatar_url":"https://avatars.githubusercontent.com/u/7649605?v=3",
      "gravatar_id":"",
      "url":"https://api.github.com/users/baxterthehacker",
      "html_url":"https://github.com/baxterthehacker",
      "followers_url":"https://api.github.com/users/baxterthehacker/followers",
      "following_url":"https://api.github.com/users/baxterthehacker/following{/other_user}",
      "gists_url":"https://api.github.com/users/baxterthehacker/gists{/gist_id}",
      "starred_url":"https://api.github.com/users/baxterthehacker/starred{/owner}{/repo}",
      "subscriptions_url":"https://api.github.com/users/baxterthehacker/subscriptions",
      "organizations_url":"https://api.github.com/users/baxterthehacker/orgs",
      "repos_url":"https://api.github.com/users/baxterthehacker/repos",
      "events_url":"https://api.github.com/users/baxterthehacker/events{/privacy}",
      "received_events_url":"https://api.github.com/users/baxterthehacker/received_events",
      "type":"User",
      "site_admin":true
    },
    "open_issues":0,
    "closed_issues":0,
    "state":"open",
    "created_at":"2016-10-07T19:26:08Z",
    "updated_at":"2016-10-07T19:26:08Z",
    "due_on":null,
    "closed_at":null
  },
  "repository":{
    "id":70275481,
    "name":"public-repo",
    "full_name":"baxterandthehackers/public-repo",
    "owner":{
      "login":"baxterandthehackers",
      "id":4312013,
      "avatar_url":"https://avatars.githubusercontent.com/u/4312013?v=3",
      "gravatar_id":"",
      "url":"https://api.github.com/users/baxterandthehackers",
      "html_url":"https://github.com/baxterandthehackers",
      "followers_url":"https://api.github.com/users/baxterandthehackers/followers",
      "following_url":"https://api.github.com/users/baxterandthehackers/following{/other_user}",
      "gists_url":"https://api.github.com/users/baxterandthehackers/gists{/gist_id}",
      "starred_url":"https://api.github.com/users/baxterandthehackers/starred{/owner}{/repo}",
      "subscriptions_url":"https://api.github.com/users/baxterandthehackers/subscriptions",
      "organizations_url":"https://api.github.com/users/baxterandthehackers/orgs",
      "repos_url":"https://api.github.com/users/baxterandthehackers/repos",
      "events_url":"https://api.github.com/users/baxterandthehackers/events{/privacy}",
      "received_events_url":"https://api.github.com/users/baxterandthehackers/received_events",
      "type":"Organization",
      "site_admin":false
    },
    "private":true,
    "html_url":"https://github.com/baxterandthehackers/public-repo",
    "description":null,
    "fork":false,
    "url":"https://api.github.com/repos/baxterandthehackers/public-repo",
    "forks_url":"https://api.github.com/repos/baxterandthehackers/public-repo/forks",
    "keys_url":"https://api.github.com/repos/baxterandthehackers/public-repo/keys{/key_id}",
    "collaborators_url":"https://api.github.com/repos/baxterandthehackers/public-repo/collaborators{/collaborator}",
    "teams_url":"https://api.github.com/repos/baxterandthehackers/public-repo/teams",
    "hooks_url":"https://api.github.com/repos/baxterandthehackers/public-repo/hooks",
    "issue_events_url":"https://api.github.com/repos/baxterandthehackers/public-repo/issues/events{/number}",
    "events_url":"https://api.github.com/repos/baxterandthehackers/public-repo/events",
    "assignees_url":"https://api.github.com/repos/baxterandthehackers/public-repo/assignees{/user}",
    "branches_url":"https://api.github.com/repos/baxterandthehackers/public-repo/branches{/branch}",
    "tags_url":"https://api.github.com/repos/baxterandthehackers/public-repo/tags",
    "blobs_url":"https://api.github.com/repos/baxterandthehackers/public-repo/git/blobs{/sha}",
    "git_tags_url":"https://api.github.com/repos/baxterandthehackers/public-repo/git/tags{/sha}",
    "git_refs_url":"https://api.github.com/repos/baxterandthehackers/public-repo/git/refs{/sha}",
    "trees_url":"https://api.github.com/repos/baxterandthehackers/public-repo/git/trees{/sha}",
    "statuses_url":"https://api.github.com/repos/baxterandthehackers/public-repo/statuses/{sha}",
    "languages_url":"https://api.github.com/repos/baxterandthehackers/public-repo/languages",
    "stargazers_url":"https://api.github.com/repos/baxterandthehackers/public-repo/stargazers",
    "contributors_url":"https://api.github.com/repos/baxterandthehackers/public-repo/contributors",
    "subscribers_url":"https://api.github.com/repos/baxterandthehackers/public-repo/subscribers",
    "subscription_url":"https://api.github.com/repos/baxterandthehackers/public-repo/subscription",
    "commits_url":"https://api.github.com/repos/baxterandthehackers/public-repo/commits{/sha}",
    "git_commits_url":"https://api.github.com/repos/baxterandthehackers/public-repo/git/commits{/sha}",
    "comments_url":"https://api.github.com/repos/baxterandthehackers/public-repo/comments{/number}",
    "issue_comment_url":"https://api.github.com/repos/baxterandthehackers/public-repo/issues/comments{/number}",
    "contents_url":"https://api.github.com/repos/baxterandthehackers/public-repo/contents/{+path}",
    "compare_url":"https://api.github.com/repos/baxterandthehackers/public-repo/compare/{base}...{head}",
    "merges_url":"https://api.github.com/repos/baxterandthehackers/public-repo/merges",
    "archive_url":"https://api.github.com/repos/baxterandthehackers/public-repo/{archive_format}{/ref}",
    "downloads_url":"https://api.github.com/repos/baxterandthehackers/public-repo/downloads",
    "issues_url":"https://api.github.com/repos/baxterandthehackers/public-repo/issues{/number}",
    "pulls_url":"https://api.github.com/repos/baxterandthehackers/public-repo/pulls{/number}",
    "milestones_url":"https://api.github.com/repos/baxterandthehackers/public-repo/milestones{/number}",
    "notifications_url":"https://api.github.com/repos/baxterandthehackers/public-repo/notifications{?since,all,participating}",
    "labels_url":"https://api.github.com/repos/baxterandthehackers/public-repo/labels{/name}",
    "releases_url":"https://api.github.com/repos/baxterandthehackers/public-repo/releases{/id}",
    "deployments_url":"https://api.github.com/repos/baxterandthehackers/public-repo/deployments",
    "created_at":"2016-10-07T19:10:12Z",
    "updated_at":"2016-10-07T19:10:12Z",
    "pushed_at":"2016-10-07T19:10:13Z",
    "git_url":"git://github.com/baxterandthehackers/public-repo.git",
    "ssh_url":"git@github.com:baxterandthehackers/public-repo.git",
    "clone_url":"https://github.com/baxterandthehackers/public-repo.git",
    "svn_url":"https://github.com/baxterandthehackers/public-repo",
    "homepage":null,
    "size":0,
    "stargazers_count":0,
    "watchers_count":0,
    "language":null,
    "has_issues":true,
    "has_downloads":true,
    "has_wiki":true,
    "has_pages":false,
    "forks_count":0,
    "mirror_url":null,
    "open_issues_count":0,
    "forks":0,
    "open_issues":0,
    "watchers":0,
    "default_branch":"master"
  },
  "organization":{
    "login":"baxterandthehackers",
    "id":4312013,
    "url":"https://api.github.com/orgs/baxterandthehackers",
    "repos_url":"https://api.github.com/orgs/baxterandthehackers/repos",
    "events_url":"https://api.github.com/orgs/baxterandthehackers/events",
    "hooks_url":"https://api.github.com/orgs/baxterandthehackers/hooks",
    "issues_url":"https://api.github.com/orgs/baxterandthehackers/issues",
    "members_url":"https://api.github.com/orgs/baxterandthehackers/members{/member}",
    "public_members_url":"https://api.github.com/orgs/baxterandthehackers/public_members{/member}",
    "avatar_url":"https://avatars.githubusercontent.com/u/4312013?v=3",
    "description":""
  },
  "sender":{
    "login":"baxterthehacker",
    "id":7649605,
    "avatar_url":"https://avatars.githubusercontent.com/u/7649605?v=3",
    "gravatar_id":"",
    "url":"https://api.github.com/users/baxterthehacker",
    "html_url":"https://github.com/baxterthehacker",
    "followers_url":"https://api.github.com/users/baxterthehacker/followers",
    "following_url":"https://api.github.com/users/baxterthehacker/following{/other_user}",
    "gists_url":"https://api.github.com/users/baxterthehacker/gists{/gist_id}",
    "starred_url":"https://api.github.com/users/baxterthehacker/starred{/owner}{/repo}",
    "subscriptions_url":"https://api.github.com/users/baxterthehacker/subscriptions",
    "organizations_url":"https://api.github.com/users/baxterthehacker/orgs",
    "repos_url":"https://api.github.com/users/baxterthehacker/repos",
    "events_url":"https://api.github.com/users/baxterthehacker/events{/privacy}",
    "received_events_url":"https://api.github.com/users/baxterthehacker/received_events",
    "type":"User",
    "site_admin":true
  }
}

OrganizationEvent

Triggered when a user is added, removed, or invited to an Organization.

Events of this type are not visible in timelines. These events are only used to trigger organization hooks.

Events API payload

Key Type Description
action string The action that was performed. Can be one of: member_added, member_removed, or member_invited.
invitation object The invitation for the user or email if the action is member_invited.
membership object The membership between the user and the organization. Not present when the action is member_invited.
organization object The organization in question.

Webhook event name

organization

Webhook payload example

{
  "action": "member_invited",
  "invitation": {
    "id": 3294302,
    "login": "baxterthehacker",
    "email": null,
    "role": "direct_member"
  },
  "membership": {
    "url": "https://api.github.com/orgs/baxterandthehackers/memberships/baxterthehacker",
    "state": "active",
    "role": "member",
    "organization_url": "https://api.github.com/orgs/baxterandthehackers",
    "user": {
      "login": "baxterthehacker",
      "id": 7649605,
      "avatar_url": "https://avatars.githubusercontent.com/u/17085448?v=3",
      "gravatar_id": "",
      "url": "https://api.github.com/users/baxterthehacker",
      "html_url": "https://github.com/baxterthehacker",
      "followers_url": "https://api.github.com/users/baxterthehacker/followers",
      "following_url": "https://api.github.com/users/baxterthehacker/following{/other_user}",
      "gists_url": "https://api.github.com/users/baxterthehacker/gists{/gist_id}",
      "starred_url": "https://api.github.com/users/baxterthehacker/starred{/owner}{/repo}",
      "subscriptions_url": "https://api.github.com/users/baxterthehacker/subscriptions",
      "organizations_url": "https://api.github.com/users/baxterthehacker/orgs",
      "repos_url": "https://api.github.com/users/baxterthehacker/repos",
      "events_url": "https://api.github.com/users/baxterthehacker/events{/privacy}",
      "received_events_url": "https://api.github.com/users/baxterthehacker/received_events",
      "type": "User",
      "site_admin": false
    }
  },
  "organization": {
    "login": "baxterandthehackers",
    "id": 4312013,
    "url": "https://api.github.com/orgs/baxterandthehackers",
    "repos_url": "https://api.github.com/orgs/baxterandthehackers/repos",
    "events_url": "https://api.github.com/orgs/baxterandthehackers/events",
    "hooks_url": "https://api.github.com/orgs/baxterandthehackers/hooks",
    "issues_url": "https://api.github.com/orgs/baxterandthehackers/issues",
    "members_url": "https://api.github.com/orgs/baxterandthehackers/members{/member}",
    "public_members_url": "https://api.github.com/orgs/baxterandthehackers/public_members{/member}",
    "avatar_url": "https://avatars.githubusercontent.com/u/4312013?v=3",
    "description": ""
  },
  "sender":{
    "login":"baxterthehacker",
    "id":7649605,
    "avatar_url":"https://avatars.githubusercontent.com/u/7649605?v=3",
    "gravatar_id":"",
    "url":"https://api.github.com/users/baxterthehacker",
    "html_url":"https://github.com/baxterthehacker",
    "followers_url":"https://api.github.com/users/baxterthehacker/followers",
    "following_url":"https://api.github.com/users/baxterthehacker/following{/other_user}",
    "gists_url":"https://api.github.com/users/baxterthehacker/gists{/gist_id}",
    "starred_url":"https://api.github.com/users/baxterthehacker/starred{/owner}{/repo}",
    "subscriptions_url":"https://api.github.com/users/baxterthehacker/subscriptions",
    "organizations_url":"https://api.github.com/users/baxterthehacker/orgs",
    "repos_url":"https://api.github.com/users/baxterthehacker/repos",
    "events_url":"https://api.github.com/users/baxterthehacker/events{/privacy}",
    "received_events_url":"https://api.github.com/users/baxterthehacker/received_events",
    "type":"User",
    "site_admin":true
  }
}

OrgBlockEvent

Triggered when an organization blocks or unblocks a user.

Events API payload

Key Type Description
action string The action performed. Can be blocked or unblocked.
blocked_user object Information about the user that was blocked or unblocked.
organization object Information about the organization that blocked or unblocked the user.
sender object Information about the user who sent the blocking/unblocking request on behalf of the organization.

Webhook event name

org_block

Webhook payload example

{
  "action": "blocked",
  "blocked_user": {
    "login": "octocat",
    "id": 583231,
    "avatar_url": "https://avatars.githubusercontent.com/u/583231?v=3",
    "gravatar_id": "",
    "url": "https://api.github.com/users/octocat",
    "html_url": "https://github.com/octocat",
    "followers_url": "https://api.github.com/users/octocat/followers",
    "following_url": "https://api.github.com/users/octocat/following{/other_user}",
    "gists_url": "https://api.github.com/users/octocat/gists{/gist_id}",
    "starred_url": "https://api.github.com/users/octocat/starred{/owner}{/repo}",
    "subscriptions_url": "https://api.github.com/users/octocat/subscriptions",
    "organizations_url": "https://api.github.com/users/octocat/orgs",
    "repos_url": "https://api.github.com/users/octocat/repos",
    "events_url": "https://api.github.com/users/octocat/events{/privacy}",
    "received_events_url": "https://api.github.com/users/octocat/received_events",
    "type": "User",
    "site_admin": false
  },
  "organization": {
    "login": "github",
    "id": 4366038,
    "url": "https://api.github.com/orgs/github",
    "repos_url": "https://api.github.com/orgs/github/repos",
    "events_url": "https://api.github.com/orgs/github/events",
    "hooks_url": "https://api.github.com/orgs/github/hooks",
    "issues_url": "https://api.github.com/orgs/github/issues",
    "members_url": "https://api.github.com/orgs/github/members{/member}",
    "public_members_url": "https://api.github.com/orgs/github/public_members{/member}",
    "avatar_url": "https://avatars.githubusercontent.com/u/4366038?v=3",
    "description": ""
  },
  "sender": {
    "login": "octodocs",
    "id": 25781999,
    "avatar_url": "https://avatars.githubusercontent.com/u/25781999?v=3",
    "gravatar_id": "",
    "url": "https://api.github.com/users/octodocs",
    "html_url": "https://github.com/octodocs",
    "followers_url": "https://api.github.com/users/octodocs/followers",
    "following_url": "https://api.github.com/users/octodocs/following{/other_user}",
    "gists_url": "https://api.github.com/users/octodocs/gists{/gist_id}",
    "starred_url": "https://api.github.com/users/octodocs/starred{/owner}{/repo}",
    "subscriptions_url": "https://api.github.com/users/octodocs/subscriptions",
    "organizations_url": "https://api.github.com/users/octodocs/orgs",
    "repos_url": "https://api.github.com/users/octodocs/repos",
    "events_url": "https://api.github.com/users/octodocs/events{/privacy}",
    "received_events_url": "https://api.github.com/users/octodocs/received_events",
    "type": "User",
    "site_admin": false
  }
}

PageBuildEvent

Represents an attempted build of a GitHub Pages site, whether successful or not.

Triggered on push to a GitHub Pages enabled branch (gh-pages for project pages, master for user and organization pages).

Events of this type are not visible in timelines. These events are only used to trigger hooks.

Events API payload

Key Type Description
build object The page build itself.

Webhook event name

page_build

Webhook payload example

{
  "id": 15995382,
  "build": {
    "url": "https://api.github.com/repos/baxterthehacker/public-repo/pages/builds/15995382",
    "status": "built",
    "error": {
      "message": null
    },
    "pusher": {
      "login": "baxterthehacker",
      "id": 6752317,
      "avatar_url": "https://avatars.githubusercontent.com/u/6752317?v=3",
      "gravatar_id": "",
      "url": "https://api.github.com/users/baxterthehacker",
      "html_url": "https://github.com/baxterthehacker",
      "followers_url": "https://api.github.com/users/baxterthehacker/followers",
      "following_url": "https://api.github.com/users/baxterthehacker/following{/other_user}",
      "gists_url": "https://api.github.com/users/baxterthehacker/gists{/gist_id}",
      "starred_url": "https://api.github.com/users/baxterthehacker/starred{/owner}{/repo}",
      "subscriptions_url": "https://api.github.com/users/baxterthehacker/subscriptions",
      "organizations_url": "https://api.github.com/users/baxterthehacker/orgs",
      "repos_url": "https://api.github.com/users/baxterthehacker/repos",
      "events_url": "https://api.github.com/users/baxterthehacker/events{/privacy}",
      "received_events_url": "https://api.github.com/users/baxterthehacker/received_events",
      "type": "User",
      "site_admin": false
    },
    "commit": "053b99542c83021d6b202d1a1f5ecd5ef7084e55",
    "duration": 3790,
    "created_at": "2015-05-05T23:40:13Z",
    "updated_at": "2015-05-05T23:40:17Z"
  },
  "repository": {
    "id": 35129377,
    "name": "public-repo",
    "full_name": "baxterthehacker/public-repo",
    "owner": {
      "login": "baxterthehacker",
      "id": 6752317,
      "avatar_url": "https://avatars.githubusercontent.com/u/6752317?v=3",
      "gravatar_id": "",
      "url": "https://api.github.com/users/baxterthehacker",
      "html_url": "https://github.com/baxterthehacker",
      "followers_url": "https://api.github.com/users/baxterthehacker/followers",
      "following_url": "https://api.github.com/users/baxterthehacker/following{/other_user}",
      "gists_url": "https://api.github.com/users/baxterthehacker/gists{/gist_id}",
      "starred_url": "https://api.github.com/users/baxterthehacker/starred{/owner}{/repo}",
      "subscriptions_url": "https://api.github.com/users/baxterthehacker/subscriptions",
      "organizations_url": "https://api.github.com/users/baxterthehacker/orgs",
      "repos_url": "https://api.github.com/users/baxterthehacker/repos",
      "events_url": "https://api.github.com/users/baxterthehacker/events{/privacy}",
      "received_events_url": "https://api.github.com/users/baxterthehacker/received_events",
      "type": "User",
      "site_admin": false
    },
    "private": false,
    "html_url": "https://github.com/baxterthehacker/public-repo",
    "description": "",
    "fork": false,
    "url": "https://api.github.com/repos/baxterthehacker/public-repo",
    "forks_url": "https://api.github.com/repos/baxterthehacker/public-repo/forks",
    "keys_url": "https://api.github.com/repos/baxterthehacker/public-repo/keys{/key_id}",
    "collaborators_url": "https://api.github.com/repos/baxterthehacker/public-repo/collaborators{/collaborator}",
    "teams_url": "https://api.github.com/repos/baxterthehacker/public-repo/teams",
    "hooks_url": "https://api.github.com/repos/baxterthehacker/public-repo/hooks",
    "issue_events_url": "https://api.github.com/repos/baxterthehacker/public-repo/issues/events{/number}",
    "events_url": "https://api.github.com/repos/baxterthehacker/public-repo/events",
    "assignees_url": "https://api.github.com/repos/baxterthehacker/public-repo/assignees{/user}",
    "branches_url": "https://api.github.com/repos/baxterthehacker/public-repo/branches{/branch}",
    "tags_url": "https://api.github.com/repos/baxterthehacker/public-repo/tags",
    "blobs_url": "https://api.github.com/repos/baxterthehacker/public-repo/git/blobs{/sha}",
    "git_tags_url": "https://api.github.com/repos/baxterthehacker/public-repo/git/tags{/sha}",
    "git_refs_url": "https://api.github.com/repos/baxterthehacker/public-repo/git/refs{/sha}",
    "trees_url": "https://api.github.com/repos/baxterthehacker/public-repo/git/trees{/sha}",
    "statuses_url": "https://api.github.com/repos/baxterthehacker/public-repo/statuses/{sha}",
    "languages_url": "https://api.github.com/repos/baxterthehacker/public-repo/languages",
    "stargazers_url": "https://api.github.com/repos/baxterthehacker/public-repo/stargazers",
    "contributors_url": "https://api.github.com/repos/baxterthehacker/public-repo/contributors",
    "subscribers_url": "https://api.github.com/repos/baxterthehacker/public-repo/subscribers",
    "subscription_url": "https://api.github.com/repos/baxterthehacker/public-repo/subscription",
    "commits_url": "https://api.github.com/repos/baxterthehacker/public-repo/commits{/sha}",
    "git_commits_url": "https://api.github.com/repos/baxterthehacker/public-repo/git/commits{/sha}",
    "comments_url": "https://api.github.com/repos/baxterthehacker/public-repo/comments{/number}",
    "issue_comment_url": "https://api.github.com/repos/baxterthehacker/public-repo/issues/comments{/number}",
    "contents_url": "https://api.github.com/repos/baxterthehacker/public-repo/contents/{+path}",
    "compare_url": "https://api.github.com/repos/baxterthehacker/public-repo/compare/{base}...{head}",
    "merges_url": "https://api.github.com/repos/baxterthehacker/public-repo/merges",
    "archive_url": "https://api.github.com/repos/baxterthehacker/public-repo/{archive_format}{/ref}",
    "downloads_url": "https://api.github.com/repos/baxterthehacker/public-repo/downloads",
    "issues_url": "https://api.github.com/repos/baxterthehacker/public-repo/issues{/number}",
    "pulls_url": "https://api.github.com/repos/baxterthehacker/public-repo/pulls{/number}",
    "milestones_url": "https://api.github.com/repos/baxterthehacker/public-repo/milestones{/number}",
    "notifications_url": "https://api.github.com/repos/baxterthehacker/public-repo/notifications{?since,all,participating}",
    "labels_url": "https://api.github.com/repos/baxterthehacker/public-repo/labels{/name}",
    "releases_url": "https://api.github.com/repos/baxterthehacker/public-repo/releases{/id}",
    "created_at": "2015-05-05T23:40:12Z",
    "updated_at": "2015-05-05T23:40:12Z",
    "pushed_at": "2015-05-05T23:40:17Z",
    "git_url": "git://github.com/baxterthehacker/public-repo.git",
    "ssh_url": "git@github.com:baxterthehacker/public-repo.git",
    "clone_url": "https://github.com/baxterthehacker/public-repo.git",
    "svn_url": "https://github.com/baxterthehacker/public-repo",
    "homepage": null,
    "size": 0,
    "stargazers_count": 0,
    "watchers_count": 0,
    "language": null,
    "has_issues": true,
    "has_downloads": true,
    "has_wiki": true,
    "has_pages": true,
    "forks_count": 0,
    "mirror_url": null,
    "open_issues_count": 0,
    "forks": 0,
    "open_issues": 0,
    "watchers": 0,
    "default_branch": "master"
  },
  "sender": {
    "login": "baxterthehacker",
    "id": 6752317,
    "avatar_url": "https://avatars.githubusercontent.com/u/6752317?v=3",
    "gravatar_id": "",
    "url": "https://api.github.com/users/baxterthehacker",
    "html_url": "https://github.com/baxterthehacker",
    "followers_url": "https://api.github.com/users/baxterthehacker/followers",
    "following_url": "https://api.github.com/users/baxterthehacker/following{/other_user}",
    "gists_url": "https://api.github.com/users/baxterthehacker/gists{/gist_id}",
    "starred_url": "https://api.github.com/users/baxterthehacker/starred{/owner}{/repo}",
    "subscriptions_url": "https://api.github.com/users/baxterthehacker/subscriptions",
    "organizations_url": "https://api.github.com/users/baxterthehacker/orgs",
    "repos_url": "https://api.github.com/users/baxterthehacker/repos",
    "events_url": "https://api.github.com/users/baxterthehacker/events{/privacy}",
    "received_events_url": "https://api.github.com/users/baxterthehacker/received_events",
    "type": "User",
    "site_admin": false
  }
}

ProjectCardEvent

Triggered when a project card is created, updated, moved, converted to an issue, or deleted.

Events API payload

Key Type Description
action string The action performed on the project card. Can be "created", "edited", "converted", "moved", or "deleted".
changes object The changes to the project card if the action was "edited" or "converted".
changes[note][from] string The previous version of the note if the action was "edited" or "converted".
after_id integer The id of the card that this card now follows if the action was "moved". Will be null if it is the first card in a column.
project_card object The project card itself.

Webhook event name

project_card

Webhook payload example

{
  "action": "created",
  "project_card": {
    "url": "https://api.github.com/projects/columns/cards/1266091",
    "column_url": "https://api.github.com/projects/columns/515520",
    "column_id": 515520,
    "id": 1266091,
    "note": null,
    "creator": {
      "login": "baxterthehacker",
      "id": 6752317,
      "avatar_url": "https://avatars.githubusercontent.com/u/6752317?v=2",
      "gravatar_id": "",
      "url": "https://api.github.com/users/baxterthehacker",
      "html_url": "https://github.com/baxterthehacker",
      "followers_url": "https://api.github.com/users/baxterthehacker/followers",
      "following_url": "https://api.github.com/users/baxterthehacker/following{/other_user}",
      "gists_url": "https://api.github.com/users/baxterthehacker/gists{/gist_id}",
      "starred_url": "https://api.github.com/users/baxterthehacker/starred{/owner}{/repo}",
      "subscriptions_url": "https://api.github.com/users/baxterthehacker/subscriptions",
      "organizations_url": "https://api.github.com/users/baxterthehacker/orgs",
      "repos_url": "https://api.github.com/users/baxterthehacker/repos",
      "events_url": "https://api.github.com/users/baxterthehacker/events{/privacy}",
      "received_events_url": "https://api.github.com/users/baxterthehacker/received_events",
      "type": "User",
      "site_admin": false
    },
    "created_at": "2017-09-27T23:37:43Z",
    "updated_at": "2017-09-27T23:39:09Z",
    "content_url":  "https://api.github.com/repos/baxterthehacker/public-repo/issues/2"
  },
  "repository": {
    "id": 35129377,
    "name": "public-repo",
    "full_name": "baxterthehacker/public-repo",
    "owner": {
      "login": "baxterthehacker",
      "id": 6752317,
      "avatar_url": "https://avatars.githubusercontent.com/u/6752317?v=3",
      "gravatar_id": "",
      "url": "https://api.github.com/users/baxterthehacker",
      "html_url": "https://github.com/baxterthehacker",
      "followers_url": "https://api.github.com/users/baxterthehacker/followers",
      "following_url": "https://api.github.com/users/baxterthehacker/following{/other_user}",
      "gists_url": "https://api.github.com/users/baxterthehacker/gists{/gist_id}",
      "starred_url": "https://api.github.com/users/baxterthehacker/starred{/owner}{/repo}",
      "subscriptions_url": "https://api.github.com/users/baxterthehacker/subscriptions",
      "organizations_url": "https://api.github.com/users/baxterthehacker/orgs",
      "repos_url": "https://api.github.com/users/baxterthehacker/repos",
      "events_url": "https://api.github.com/users/baxterthehacker/events{/privacy}",
      "received_events_url": "https://api.github.com/users/baxterthehacker/received_events",
      "type": "User",
      "site_admin": false
    },
    "private": false,
    "html_url": "https://github.com/baxterthehacker/public-repo",
    "description": "",
    "fork": false,
    "url": "https://api.github.com/repos/baxterthehacker/public-repo",
    "forks_url": "https://api.github.com/repos/baxterthehacker/public-repo/forks",
    "keys_url": "https://api.github.com/repos/baxterthehacker/public-repo/keys{/key_id}",
    "collaborators_url": "https://api.github.com/repos/baxterthehacker/public-repo/collaborators{/collaborator}",
    "teams_url": "https://api.github.com/repos/baxterthehacker/public-repo/teams",
    "hooks_url": "https://api.github.com/repos/baxterthehacker/public-repo/hooks",
    "issue_events_url": "https://api.github.com/repos/baxterthehacker/public-repo/issues/events{/number}",
    "events_url": "https://api.github.com/repos/baxterthehacker/public-repo/events",
    "assignees_url": "https://api.github.com/repos/baxterthehacker/public-repo/assignees{/user}",
    "branches_url": "https://api.github.com/repos/baxterthehacker/public-repo/branches{/branch}",
    "tags_url": "https://api.github.com/repos/baxterthehacker/public-repo/tags",
    "blobs_url": "https://api.github.com/repos/baxterthehacker/public-repo/git/blobs{/sha}",
    "git_tags_url": "https://api.github.com/repos/baxterthehacker/public-repo/git/tags{/sha}",
    "git_refs_url": "https://api.github.com/repos/baxterthehacker/public-repo/git/refs{/sha}",
    "trees_url": "https://api.github.com/repos/baxterthehacker/public-repo/git/trees{/sha}",
    "statuses_url": "https://api.github.com/repos/baxterthehacker/public-repo/statuses/{sha}",
    "languages_url": "https://api.github.com/repos/baxterthehacker/public-repo/languages",
    "stargazers_url": "https://api.github.com/repos/baxterthehacker/public-repo/stargazers",
    "contributors_url": "https://api.github.com/repos/baxterthehacker/public-repo/contributors",
    "subscribers_url": "https://api.github.com/repos/baxterthehacker/public-repo/subscribers",
    "subscription_url": "https://api.github.com/repos/baxterthehacker/public-repo/subscription",
    "commits_url": "https://api.github.com/repos/baxterthehacker/public-repo/commits{/sha}",
    "git_commits_url": "https://api.github.com/repos/baxterthehacker/public-repo/git/commits{/sha}",
    "comments_url": "https://api.github.com/repos/baxterthehacker/public-repo/comments{/number}",
    "issue_comment_url": "https://api.github.com/repos/baxterthehacker/public-repo/issues/comments{/number}",
    "contents_url": "https://api.github.com/repos/baxterthehacker/public-repo/contents/{+path}",
    "compare_url": "https://api.github.com/repos/baxterthehacker/public-repo/compare/{base}...{head}",
    "merges_url": "https://api.github.com/repos/baxterthehacker/public-repo/merges",
    "archive_url": "https://api.github.com/repos/baxterthehacker/public-repo/{archive_format}{/ref}",
    "downloads_url": "https://api.github.com/repos/baxterthehacker/public-repo/downloads",
    "issues_url": "https://api.github.com/repos/baxterthehacker/public-repo/issues{/number}",
    "pulls_url": "https://api.github.com/repos/baxterthehacker/public-repo/pulls{/number}",
    "milestones_url": "https://api.github.com/repos/baxterthehacker/public-repo/milestones{/number}",
    "notifications_url": "https://api.github.com/repos/baxterthehacker/public-repo/notifications{?since,all,participating}",
    "labels_url": "https://api.github.com/repos/baxterthehacker/public-repo/labels{/name}",
    "releases_url": "https://api.github.com/repos/baxterthehacker/public-repo/releases{/id}",
    "created_at": "2015-05-05T23:40:12Z",
    "updated_at": "2015-05-05T23:40:12Z",
    "pushed_at": "2015-05-05T23:40:27Z",
    "git_url": "git://github.com/baxterthehacker/public-repo.git",
    "ssh_url": "git@github.com:baxterthehacker/public-repo.git",
    "clone_url": "https://github.com/baxterthehacker/public-repo.git",
    "svn_url": "https://github.com/baxterthehacker/public-repo",
    "homepage": null,
    "size": 0,
    "stargazers_count": 0,
    "watchers_count": 0,
    "language": null,
    "has_issues": true,
    "has_downloads": true,
    "has_wiki": true,
    "has_pages": true,
    "forks_count": 0,
    "mirror_url": null,
    "open_issues_count": 2,
    "forks": 0,
    "open_issues": 2,
    "watchers": 0,
    "default_branch": "master"
  },
  "organization": {
    "login": "baxterandthehackers",
    "id": 7649605,
    "url": "https://api.github.com/orgs/baxterandthehackers",
    "repos_url": "https://api.github.com/orgs/baxterandthehackers/repos",
    "events_url": "https://api.github.com/orgs/baxterandthehackers/events",
    "members_url": "https://api.github.com/orgs/baxterandthehackers/members{/member}",
    "public_members_url": "https://api.github.com/orgs/baxterandthehackers/public_members{/member}",
    "avatar_url": "https://avatars.githubusercontent.com/u/7649605?v=2"
  },
  "sender": {
    "login": "baxterthehacker",
    "id": 6752317,
    "avatar_url": "https://avatars.githubusercontent.com/u/6752317?v=2",
    "gravatar_id": "",
    "url": "https://api.github.com/users/baxterthehacker",
    "html_url": "https://github.com/baxterthehacker",
    "followers_url": "https://api.github.com/users/baxterthehacker/followers",
    "following_url": "https://api.github.com/users/baxterthehacker/following{/other_user}",
    "gists_url": "https://api.github.com/users/baxterthehacker/gists{/gist_id}",
    "starred_url": "https://api.github.com/users/baxterthehacker/starred{/owner}{/repo}",
    "subscriptions_url": "https://api.github.com/users/baxterthehacker/subscriptions",
    "organizations_url": "https://api.github.com/users/baxterthehacker/orgs",
    "repos_url": "https://api.github.com/users/baxterthehacker/repos",
    "events_url": "https://api.github.com/users/baxterthehacker/events{/privacy}",
    "received_events_url": "https://api.github.com/users/baxterthehacker/received_events",
    "type": "User",
    "site_admin": false
  }
}

ProjectColumnEvent

Triggered when a project column is created, updated, moved, or deleted.

Events API payload

Key Type Description
action string The action that was performed on the project column. Can be one of "created", "edited", "moved" or "deleted".
changes object The changes to the project column if the action was "edited".
changes[name][from] string The previous version of the name if the action was "edited".
after_id integer The id of the column that this column now follows if the action was "moved". Will be null if it is the first column in a project.
project_column object The project column itself.

Webhook event name

project_column

Webhook payload example

{
  "action": "created",
  "project_column": {
    "url": "https://api.github.com/projects/columns/515520",
    "project_url": "https://api.github.com/projects/288065",
    "cards_url": "https://api.github.com/projects/columns/515520/cards",
    "id": 515520,
    "name": "High Priority",
    "created_at": "2017-09-27T23:37:43Z",
    "updated_at": "2017-09-27T23:39:09Z"
  },
  "repository": {
    "id": 35129377,
    "name": "public-repo",
    "full_name": "baxterthehacker/public-repo",
    "owner": {
      "login": "baxterthehacker",
      "id": 6752317,
      "avatar_url": "https://avatars.githubusercontent.com/u/6752317?v=3",
      "gravatar_id": "",
      "url": "https://api.github.com/users/baxterthehacker",
      "html_url": "https://github.com/baxterthehacker",
      "followers_url": "https://api.github.com/users/baxterthehacker/followers",
      "following_url": "https://api.github.com/users/baxterthehacker/following{/other_user}",
      "gists_url": "https://api.github.com/users/baxterthehacker/gists{/gist_id}",
      "starred_url": "https://api.github.com/users/baxterthehacker/starred{/owner}{/repo}",
      "subscriptions_url": "https://api.github.com/users/baxterthehacker/subscriptions",
      "organizations_url": "https://api.github.com/users/baxterthehacker/orgs",
      "repos_url": "https://api.github.com/users/baxterthehacker/repos",
      "events_url": "https://api.github.com/users/baxterthehacker/events{/privacy}",
      "received_events_url": "https://api.github.com/users/baxterthehacker/received_events",
      "type": "User",
      "site_admin": false
    },
    "private": false,
    "html_url": "https://github.com/baxterthehacker/public-repo",
    "description": "",
    "fork": false,
    "url": "https://api.github.com/repos/baxterthehacker/public-repo",
    "forks_url": "https://api.github.com/repos/baxterthehacker/public-repo/forks",
    "keys_url": "https://api.github.com/repos/baxterthehacker/public-repo/keys{/key_id}",
    "collaborators_url": "https://api.github.com/repos/baxterthehacker/public-repo/collaborators{/collaborator}",
    "teams_url": "https://api.github.com/repos/baxterthehacker/public-repo/teams",
    "hooks_url": "https://api.github.com/repos/baxterthehacker/public-repo/hooks",
    "issue_events_url": "https://api.github.com/repos/baxterthehacker/public-repo/issues/events{/number}",
    "events_url": "https://api.github.com/repos/baxterthehacker/public-repo/events",
    "assignees_url": "https://api.github.com/repos/baxterthehacker/public-repo/assignees{/user}",
    "branches_url": "https://api.github.com/repos/baxterthehacker/public-repo/branches{/branch}",
    "tags_url": "https://api.github.com/repos/baxterthehacker/public-repo/tags",
    "blobs_url": "https://api.github.com/repos/baxterthehacker/public-repo/git/blobs{/sha}",
    "git_tags_url": "https://api.github.com/repos/baxterthehacker/public-repo/git/tags{/sha}",
    "git_refs_url": "https://api.github.com/repos/baxterthehacker/public-repo/git/refs{/sha}",
    "trees_url": "https://api.github.com/repos/baxterthehacker/public-repo/git/trees{/sha}",
    "statuses_url": "https://api.github.com/repos/baxterthehacker/public-repo/statuses/{sha}",
    "languages_url": "https://api.github.com/repos/baxterthehacker/public-repo/languages",
    "stargazers_url": "https://api.github.com/repos/baxterthehacker/public-repo/stargazers",
    "contributors_url": "https://api.github.com/repos/baxterthehacker/public-repo/contributors",
    "subscribers_url": "https://api.github.com/repos/baxterthehacker/public-repo/subscribers",
    "subscription_url": "https://api.github.com/repos/baxterthehacker/public-repo/subscription",
    "commits_url": "https://api.github.com/repos/baxterthehacker/public-repo/commits{/sha}",
    "git_commits_url": "https://api.github.com/repos/baxterthehacker/public-repo/git/commits{/sha}",
    "comments_url": "https://api.github.com/repos/baxterthehacker/public-repo/comments{/number}",
    "issue_comment_url": "https://api.github.com/repos/baxterthehacker/public-repo/issues/comments{/number}",
    "contents_url": "https://api.github.com/repos/baxterthehacker/public-repo/contents/{+path}",
    "compare_url": "https://api.github.com/repos/baxterthehacker/public-repo/compare/{base}...{head}",
    "merges_url": "https://api.github.com/repos/baxterthehacker/public-repo/merges",
    "archive_url": "https://api.github.com/repos/baxterthehacker/public-repo/{archive_format}{/ref}",
    "downloads_url": "https://api.github.com/repos/baxterthehacker/public-repo/downloads",
    "issues_url": "https://api.github.com/repos/baxterthehacker/public-repo/issues{/number}",
    "pulls_url": "https://api.github.com/repos/baxterthehacker/public-repo/pulls{/number}",
    "milestones_url": "https://api.github.com/repos/baxterthehacker/public-repo/milestones{/number}",
    "notifications_url": "https://api.github.com/repos/baxterthehacker/public-repo/notifications{?since,all,participating}",
    "labels_url": "https://api.github.com/repos/baxterthehacker/public-repo/labels{/name}",
    "releases_url": "https://api.github.com/repos/baxterthehacker/public-repo/releases{/id}",
    "created_at": "2015-05-05T23:40:12Z",
    "updated_at": "2015-05-05T23:40:12Z",
    "pushed_at": "2015-05-05T23:40:27Z",
    "git_url": "git://github.com/baxterthehacker/public-repo.git",
    "ssh_url": "git@github.com:baxterthehacker/public-repo.git",
    "clone_url": "https://github.com/baxterthehacker/public-repo.git",
    "svn_url": "https://github.com/baxterthehacker/public-repo",
    "homepage": null,
    "size": 0,
    "stargazers_count": 0,
    "watchers_count": 0,
    "language": null,
    "has_issues": true,
    "has_downloads": true,
    "has_wiki": true,
    "has_pages": true,
    "forks_count": 0,
    "mirror_url": null,
    "open_issues_count": 2,
    "forks": 0,
    "open_issues": 2,
    "watchers": 0,
    "default_branch": "master"
  },
  "organization": {
    "login": "baxterandthehackers",
    "id": 7649605,
    "url": "https://api.github.com/orgs/baxterandthehackers",
    "repos_url": "https://api.github.com/orgs/baxterandthehackers/repos",
    "events_url": "https://api.github.com/orgs/baxterandthehackers/events",
    "members_url": "https://api.github.com/orgs/baxterandthehackers/members{/member}",
    "public_members_url": "https://api.github.com/orgs/baxterandthehackers/public_members{/member}",
    "avatar_url": "https://avatars.githubusercontent.com/u/7649605?v=2"
  },
  "sender": {
    "login": "baxterthehacker",
    "id": 6752317,
    "avatar_url": "https://avatars.githubusercontent.com/u/6752317?v=2",
    "gravatar_id": "",
    "url": "https://api.github.com/users/baxterthehacker",
    "html_url": "https://github.com/baxterthehacker",
    "followers_url": "https://api.github.com/users/baxterthehacker/followers",
    "following_url": "https://api.github.com/users/baxterthehacker/following{/other_user}",
    "gists_url": "https://api.github.com/users/baxterthehacker/gists{/gist_id}",
    "starred_url": "https://api.github.com/users/baxterthehacker/starred{/owner}{/repo}",
    "subscriptions_url": "https://api.github.com/users/baxterthehacker/subscriptions",
    "organizations_url": "https://api.github.com/users/baxterthehacker/orgs",
    "repos_url": "https://api.github.com/users/baxterthehacker/repos",
    "events_url": "https://api.github.com/users/baxterthehacker/events{/privacy}",
    "received_events_url": "https://api.github.com/users/baxterthehacker/received_events",
    "type": "User",
    "site_admin": false
  }
}

ProjectEvent

Triggered when a project is created, updated, closed, reopened, or deleted.

Events API payload

Key Type Description
action string The action that was performed on the project. Can be one of "created", "edited", "closed", "reopened", or "deleted".
changes object The changes to the project if the action was "edited".
changes[name][from] string The previous version of the name if the action was "edited".
changes[body][from] string The previous version of the body if the action was "edited".
project object The project itself.

Webhook event name

project

Webhook payload example

{
  "action": "created",
  "project": {
    "owner_url": "https://api.github.com/repos/baxterthehacker/public-repo",
    "url": "https://api.github.com/projects/288065",
    "columns_url": "https://api.github.com/projects/288065/columns",
    "id": 288065,
    "name": "2017",
    "body": "Roadmap for work to be done in 2017",
    "number": 10,
    "state": "open",
    "creator": {
      "login": "baxterthehacker",
      "id": 6752317,
      "avatar_url": "https://avatars.githubusercontent.com/u/6752317?v=2",
      "gravatar_id": "",
      "url": "https://api.github.com/users/baxterthehacker",
      "html_url": "https://github.com/baxterthehacker",
      "followers_url": "https://api.github.com/users/baxterthehacker/followers",
      "following_url": "https://api.github.com/users/baxterthehacker/following{/other_user}",
      "gists_url": "https://api.github.com/users/baxterthehacker/gists{/gist_id}",
      "starred_url": "https://api.github.com/users/baxterthehacker/starred{/owner}{/repo}",
      "subscriptions_url": "https://api.github.com/users/baxterthehacker/subscriptions",
      "organizations_url": "https://api.github.com/users/baxterthehacker/orgs",
      "repos_url": "https://api.github.com/users/baxterthehacker/repos",
      "events_url": "https://api.github.com/users/baxterthehacker/events{/privacy}",
      "received_events_url": "https://api.github.com/users/baxterthehacker/received_events",
      "type": "User",
      "site_admin": false
    },
    "created_at": "2017-09-27T23:37:43Z",
    "updated_at": "2017-09-27T23:39:09Z"
  },
  "repository": {
    "id": 35129377,
    "name": "public-repo",
    "full_name": "baxterthehacker/public-repo",
    "owner": {
      "login": "baxterthehacker",
      "id": 6752317,
      "avatar_url": "https://avatars.githubusercontent.com/u/6752317?v=3",
      "gravatar_id": "",
      "url": "https://api.github.com/users/baxterthehacker",
      "html_url": "https://github.com/baxterthehacker",
      "followers_url": "https://api.github.com/users/baxterthehacker/followers",
      "following_url": "https://api.github.com/users/baxterthehacker/following{/other_user}",
      "gists_url": "https://api.github.com/users/baxterthehacker/gists{/gist_id}",
      "starred_url": "https://api.github.com/users/baxterthehacker/starred{/owner}{/repo}",
      "subscriptions_url": "https://api.github.com/users/baxterthehacker/subscriptions",
      "organizations_url": "https://api.github.com/users/baxterthehacker/orgs",
      "repos_url": "https://api.github.com/users/baxterthehacker/repos",
      "events_url": "https://api.github.com/users/baxterthehacker/events{/privacy}",
      "received_events_url": "https://api.github.com/users/baxterthehacker/received_events",
      "type": "User",
      "site_admin": false
    },
    "private": false,
    "html_url": "https://github.com/baxterthehacker/public-repo",
    "description": "",
    "fork": false,
    "url": "https://api.github.com/repos/baxterthehacker/public-repo",
    "forks_url": "https://api.github.com/repos/baxterthehacker/public-repo/forks",
    "keys_url": "https://api.github.com/repos/baxterthehacker/public-repo/keys{/key_id}",
    "collaborators_url": "https://api.github.com/repos/baxterthehacker/public-repo/collaborators{/collaborator}",
    "teams_url": "https://api.github.com/repos/baxterthehacker/public-repo/teams",
    "hooks_url": "https://api.github.com/repos/baxterthehacker/public-repo/hooks",
    "issue_events_url": "https://api.github.com/repos/baxterthehacker/public-repo/issues/events{/number}",
    "events_url": "https://api.github.com/repos/baxterthehacker/public-repo/events",
    "assignees_url": "https://api.github.com/repos/baxterthehacker/public-repo/assignees{/user}",
    "branches_url": "https://api.github.com/repos/baxterthehacker/public-repo/branches{/branch}",
    "tags_url": "https://api.github.com/repos/baxterthehacker/public-repo/tags",
    "blobs_url": "https://api.github.com/repos/baxterthehacker/public-repo/git/blobs{/sha}",
    "git_tags_url": "https://api.github.com/repos/baxterthehacker/public-repo/git/tags{/sha}",
    "git_refs_url": "https://api.github.com/repos/baxterthehacker/public-repo/git/refs{/sha}",
    "trees_url": "https://api.github.com/repos/baxterthehacker/public-repo/git/trees{/sha}",
    "statuses_url": "https://api.github.com/repos/baxterthehacker/public-repo/statuses/{sha}",
    "languages_url": "https://api.github.com/repos/baxterthehacker/public-repo/languages",
    "stargazers_url": "https://api.github.com/repos/baxterthehacker/public-repo/stargazers",
    "contributors_url": "https://api.github.com/repos/baxterthehacker/public-repo/contributors",
    "subscribers_url": "https://api.github.com/repos/baxterthehacker/public-repo/subscribers",
    "subscription_url": "https://api.github.com/repos/baxterthehacker/public-repo/subscription",
    "commits_url": "https://api.github.com/repos/baxterthehacker/public-repo/commits{/sha}",
    "git_commits_url": "https://api.github.com/repos/baxterthehacker/public-repo/git/commits{/sha}",
    "comments_url": "https://api.github.com/repos/baxterthehacker/public-repo/comments{/number}",
    "issue_comment_url": "https://api.github.com/repos/baxterthehacker/public-repo/issues/comments{/number}",
    "contents_url": "https://api.github.com/repos/baxterthehacker/public-repo/contents/{+path}",
    "compare_url": "https://api.github.com/repos/baxterthehacker/public-repo/compare/{base}...{head}",
    "merges_url": "https://api.github.com/repos/baxterthehacker/public-repo/merges",
    "archive_url": "https://api.github.com/repos/baxterthehacker/public-repo/{archive_format}{/ref}",
    "downloads_url": "https://api.github.com/repos/baxterthehacker/public-repo/downloads",
    "issues_url": "https://api.github.com/repos/baxterthehacker/public-repo/issues{/number}",
    "pulls_url": "https://api.github.com/repos/baxterthehacker/public-repo/pulls{/number}",
    "milestones_url": "https://api.github.com/repos/baxterthehacker/public-repo/milestones{/number}",
    "notifications_url": "https://api.github.com/repos/baxterthehacker/public-repo/notifications{?since,all,participating}",
    "labels_url": "https://api.github.com/repos/baxterthehacker/public-repo/labels{/name}",
    "releases_url": "https://api.github.com/repos/baxterthehacker/public-repo/releases{/id}",
    "created_at": "2015-05-05T23:40:12Z",
    "updated_at": "2015-05-05T23:40:12Z",
    "pushed_at": "2015-05-05T23:40:27Z",
    "git_url": "git://github.com/baxterthehacker/public-repo.git",
    "ssh_url": "git@github.com:baxterthehacker/public-repo.git",
    "clone_url": "https://github.com/baxterthehacker/public-repo.git",
    "svn_url": "https://github.com/baxterthehacker/public-repo",
    "homepage": null,
    "size": 0,
    "stargazers_count": 0,
    "watchers_count": 0,
    "language": null,
    "has_issues": true,
    "has_downloads": true,
    "has_wiki": true,
    "has_pages": true,
    "forks_count": 0,
    "mirror_url": null,
    "open_issues_count": 2,
    "forks": 0,
    "open_issues": 2,
    "watchers": 0,
    "default_branch": "master"
  },
  "organization": {
    "login": "baxterandthehackers",
    "id": 7649605,
    "url": "https://api.github.com/orgs/baxterandthehackers",
    "repos_url": "https://api.github.com/orgs/baxterandthehackers/repos",
    "events_url": "https://api.github.com/orgs/baxterandthehackers/events",
    "members_url": "https://api.github.com/orgs/baxterandthehackers/members{/member}",
    "public_members_url": "https://api.github.com/orgs/baxterandthehackers/public_members{/member}",
    "avatar_url": "https://avatars.githubusercontent.com/u/7649605?v=2"
  },
  "sender": {
    "login": "baxterthehacker",
    "id": 6752317,
    "avatar_url": "https://avatars.githubusercontent.com/u/6752317?v=2",
    "gravatar_id": "",
    "url": "https://api.github.com/users/baxterthehacker",
    "html_url": "https://github.com/baxterthehacker",
    "followers_url": "https://api.github.com/users/baxterthehacker/followers",
    "following_url": "https://api.github.com/users/baxterthehacker/following{/other_user}",
    "gists_url": "https://api.github.com/users/baxterthehacker/gists{/gist_id}",
    "starred_url": "https://api.github.com/users/baxterthehacker/starred{/owner}{/repo}",
    "subscriptions_url": "https://api.github.com/users/baxterthehacker/subscriptions",
    "organizations_url": "https://api.github.com/users/baxterthehacker/orgs",
    "repos_url": "https://api.github.com/users/baxterthehacker/repos",
    "events_url": "https://api.github.com/users/baxterthehacker/events{/privacy}",
    "received_events_url": "https://api.github.com/users/baxterthehacker/received_events",
    "type": "User",
    "site_admin": false
  }
}

PublicEvent

Triggered when a private repository is open sourced. Without a doubt: the best GitHub event.

Events API payload

Webhook event name

public

Webhook payload example

{
  "repository": {
    "id": 35129377,
    "name": "public-repo",
    "full_name": "baxterthehacker/public-repo",
    "owner": {
      "login": "baxterthehacker",
      "id": 6752317,
      "avatar_url": "https://avatars.githubusercontent.com/u/6752317?v=3",
      "gravatar_id": "",
      "url": "https://api.github.com/users/baxterthehacker",
      "html_url": "https://github.com/baxterthehacker",
      "followers_url": "https://api.github.com/users/baxterthehacker/followers",
      "following_url": "https://api.github.com/users/baxterthehacker/following{/other_user}",
      "gists_url": "https://api.github.com/users/baxterthehacker/gists{/gist_id}",
      "starred_url": "https://api.github.com/users/baxterthehacker/starred{/owner}{/repo}",
      "subscriptions_url": "https://api.github.com/users/baxterthehacker/subscriptions",
      "organizations_url": "https://api.github.com/users/baxterthehacker/orgs",
      "repos_url": "https://api.github.com/users/baxterthehacker/repos",
      "events_url": "https://api.github.com/users/baxterthehacker/events{/privacy}",
      "received_events_url": "https://api.github.com/users/baxterthehacker/received_events",
      "type": "User",
      "site_admin": false
    },
    "private": false,
    "html_url": "https://github.com/baxterthehacker/public-repo",
    "description": "",
    "fork": false,
    "url": "https://api.github.com/repos/baxterthehacker/public-repo",
    "forks_url": "https://api.github.com/repos/baxterthehacker/public-repo/forks",
    "keys_url": "https://api.github.com/repos/baxterthehacker/public-repo/keys{/key_id}",
    "collaborators_url": "https://api.github.com/repos/baxterthehacker/public-repo/collaborators{/collaborator}",
    "teams_url": "https://api.github.com/repos/baxterthehacker/public-repo/teams",
    "hooks_url": "https://api.github.com/repos/baxterthehacker/public-repo/hooks",
    "issue_events_url": "https://api.github.com/repos/baxterthehacker/public-repo/issues/events{/number}",
    "events_url": "https://api.github.com/repos/baxterthehacker/public-repo/events",
    "assignees_url": "https://api.github.com/repos/baxterthehacker/public-repo/assignees{/user}",
    "branches_url": "https://api.github.com/repos/baxterthehacker/public-repo/branches{/branch}",
    "tags_url": "https://api.github.com/repos/baxterthehacker/public-repo/tags",
    "blobs_url": "https://api.github.com/repos/baxterthehacker/public-repo/git/blobs{/sha}",
    "git_tags_url": "https://api.github.com/repos/baxterthehacker/public-repo/git/tags{/sha}",
    "git_refs_url": "https://api.github.com/repos/baxterthehacker/public-repo/git/refs{/sha}",
    "trees_url": "https://api.github.com/repos/baxterthehacker/public-repo/git/trees{/sha}",
    "statuses_url": "https://api.github.com/repos/baxterthehacker/public-repo/statuses/{sha}",
    "languages_url": "https://api.github.com/repos/baxterthehacker/public-repo/languages",
    "stargazers_url": "https://api.github.com/repos/baxterthehacker/public-repo/stargazers",
    "contributors_url": "https://api.github.com/repos/baxterthehacker/public-repo/contributors",
    "subscribers_url": "https://api.github.com/repos/baxterthehacker/public-repo/subscribers",
    "subscription_url": "https://api.github.com/repos/baxterthehacker/public-repo/subscription",
    "commits_url": "https://api.github.com/repos/baxterthehacker/public-repo/commits{/sha}",
    "git_commits_url": "https://api.github.com/repos/baxterthehacker/public-repo/git/commits{/sha}",
    "comments_url": "https://api.github.com/repos/baxterthehacker/public-repo/comments{/number}",
    "issue_comment_url": "https://api.github.com/repos/baxterthehacker/public-repo/issues/comments{/number}",
    "contents_url": "https://api.github.com/repos/baxterthehacker/public-repo/contents/{+path}",
    "compare_url": "https://api.github.com/repos/baxterthehacker/public-repo/compare/{base}...{head}",
    "merges_url": "https://api.github.com/repos/baxterthehacker/public-repo/merges",
    "archive_url": "https://api.github.com/repos/baxterthehacker/public-repo/{archive_format}{/ref}",
    "downloads_url": "https://api.github.com/repos/baxterthehacker/public-repo/downloads",
    "issues_url": "https://api.github.com/repos/baxterthehacker/public-repo/issues{/number}",
    "pulls_url": "https://api.github.com/repos/baxterthehacker/public-repo/pulls{/number}",
    "milestones_url": "https://api.github.com/repos/baxterthehacker/public-repo/milestones{/number}",
    "notifications_url": "https://api.github.com/repos/baxterthehacker/public-repo/notifications{?since,all,participating}",
    "labels_url": "https://api.github.com/repos/baxterthehacker/public-repo/labels{/name}",
    "releases_url": "https://api.github.com/repos/baxterthehacker/public-repo/releases{/id}",
    "created_at": "2015-05-05T23:40:12Z",
    "updated_at": "2015-05-05T23:40:41Z",
    "pushed_at": "2015-05-05T23:40:40Z",
    "git_url": "git://github.com/baxterthehacker/public-repo.git",
    "ssh_url": "git@github.com:baxterthehacker/public-repo.git",
    "clone_url": "https://github.com/baxterthehacker/public-repo.git",
    "svn_url": "https://github.com/baxterthehacker/public-repo",
    "homepage": null,
    "size": 0,
    "stargazers_count": 0,
    "watchers_count": 0,
    "language": null,
    "has_issues": true,
    "has_downloads": true,
    "has_wiki": true,
    "has_pages": true,
    "forks_count": 0,
    "mirror_url": null,
    "open_issues_count": 2,
    "forks": 0,
    "open_issues": 2,
    "watchers": 0,
    "default_branch": "master"
  },
  "sender": {
    "login": "baxterthehacker",
    "id": 6752317,
    "avatar_url": "https://avatars.githubusercontent.com/u/6752317?v=3",
    "gravatar_id": "",
    "url": "https://api.github.com/users/baxterthehacker",
    "html_url": "https://github.com/baxterthehacker",
    "followers_url": "https://api.github.com/users/baxterthehacker/followers",
    "following_url": "https://api.github.com/users/baxterthehacker/following{/other_user}",
    "gists_url": "https://api.github.com/users/baxterthehacker/gists{/gist_id}",
    "starred_url": "https://api.github.com/users/baxterthehacker/starred{/owner}{/repo}",
    "subscriptions_url": "https://api.github.com/users/baxterthehacker/subscriptions",
    "organizations_url": "https://api.github.com/users/baxterthehacker/orgs",
    "repos_url": "https://api.github.com/users/baxterthehacker/repos",
    "events_url": "https://api.github.com/users/baxterthehacker/events{/privacy}",
    "received_events_url": "https://api.github.com/users/baxterthehacker/received_events",
    "type": "User",
    "site_admin": false
  }
}

PullRequestEvent

Triggered when a pull request is assigned, unassigned, labeled, unlabeled, opened, edited, closed, reopened, or synchronized. Also triggered when a pull request review is requested, or when a review request is removed.

Events API payload

Key Type Description
action string The action that was performed. Can be one of "assigned", "unassigned", "review_requested", "review_request_removed", "labeled", "unlabeled", "opened", "edited", "closed", or "reopened". If the action is "closed" and the merged key is false, the pull request was closed with unmerged commits. If the action is "closed" and the merged key is true, the pull request was merged. While webhooks are also triggered when a pull request is synchronized, Events API timelines don't include pull request events with the "synchronize" action.
number integer The pull request number.
changes object The changes to the comment if the action was "edited".
changes[title][from] string The previous version of the title if the action was "edited".
changes[body][from] string The previous version of the body if the action was "edited".
pull_request object The pull request itself.

Webhook event name

pull_request

Webhook payload example

Deliveries for review_requested and review_request_removed events will have an additional field called requested_reviewers.

{
  "action": "opened",
  "number": 1,
  "pull_request": {
    "url": "https://api.github.com/repos/baxterthehacker/public-repo/pulls/1",
    "id": 34778301,
    "html_url": "https://github.com/baxterthehacker/public-repo/pull/1",
    "diff_url": "https://github.com/baxterthehacker/public-repo/pull/1.diff",
    "patch_url": "https://github.com/baxterthehacker/public-repo/pull/1.patch",
    "issue_url": "https://api.github.com/repos/baxterthehacker/public-repo/issues/1",
    "number": 1,
    "state": "open",
    "locked": false,
    "title": "Update the README with new information",
    "user": {
      "login": "baxterthehacker",
      "id": 6752317,
      "avatar_url": "https://avatars.githubusercontent.com/u/6752317?v=3",
      "gravatar_id": "",
      "url": "https://api.github.com/users/baxterthehacker",
      "html_url": "https://github.com/baxterthehacker",
      "followers_url": "https://api.github.com/users/baxterthehacker/followers",
      "following_url": "https://api.github.com/users/baxterthehacker/following{/other_user}",
      "gists_url": "https://api.github.com/users/baxterthehacker/gists{/gist_id}",
      "starred_url": "https://api.github.com/users/baxterthehacker/starred{/owner}{/repo}",
      "subscriptions_url": "https://api.github.com/users/baxterthehacker/subscriptions",
      "organizations_url": "https://api.github.com/users/baxterthehacker/orgs",
      "repos_url": "https://api.github.com/users/baxterthehacker/repos",
      "events_url": "https://api.github.com/users/baxterthehacker/events{/privacy}",
      "received_events_url": "https://api.github.com/users/baxterthehacker/received_events",
      "type": "User",
      "site_admin": false
    },
    "body": "This is a pretty simple change that we need to pull into master.",
    "created_at": "2015-05-05T23:40:27Z",
    "updated_at": "2015-05-05T23:40:27Z",
    "closed_at": null,
    "merged_at": null,
    "merge_commit_sha": null,
    "assignee": null,
    "milestone": null,
    "commits_url": "https://api.github.com/repos/baxterthehacker/public-repo/pulls/1/commits",
    "review_comments_url": "https://api.github.com/repos/baxterthehacker/public-repo/pulls/1/comments",
    "review_comment_url": "https://api.github.com/repos/baxterthehacker/public-repo/pulls/comments{/number}",
    "comments_url": "https://api.github.com/repos/baxterthehacker/public-repo/issues/1/comments",
    "statuses_url": "https://api.github.com/repos/baxterthehacker/public-repo/statuses/0d1a26e67d8f5eaf1f6ba5c57fc3c7d91ac0fd1c",
    "head": {
      "label": "baxterthehacker:changes",
      "ref": "changes",
      "sha": "0d1a26e67d8f5eaf1f6ba5c57fc3c7d91ac0fd1c",
      "user": {
        "login": "baxterthehacker",
        "id": 6752317,
        "avatar_url": "https://avatars.githubusercontent.com/u/6752317?v=3",
        "gravatar_id": "",
        "url": "https://api.github.com/users/baxterthehacker",
        "html_url": "https://github.com/baxterthehacker",
        "followers_url": "https://api.github.com/users/baxterthehacker/followers",
        "following_url": "https://api.github.com/users/baxterthehacker/following{/other_user}",
        "gists_url": "https://api.github.com/users/baxterthehacker/gists{/gist_id}",
        "starred_url": "https://api.github.com/users/baxterthehacker/starred{/owner}{/repo}",
        "subscriptions_url": "https://api.github.com/users/baxterthehacker/subscriptions",
        "organizations_url": "https://api.github.com/users/baxterthehacker/orgs",
        "repos_url": "https://api.github.com/users/baxterthehacker/repos",
        "events_url": "https://api.github.com/users/baxterthehacker/events{/privacy}",
        "received_events_url": "https://api.github.com/users/baxterthehacker/received_events",
        "type": "User",
        "site_admin": false
      },
      "repo": {
        "id": 35129377,
        "name": "public-repo",
        "full_name": "baxterthehacker/public-repo",
        "owner": {
          "login": "baxterthehacker",
          "id": 6752317,
          "avatar_url": "https://avatars.githubusercontent.com/u/6752317?v=3",
          "gravatar_id": "",
          "url": "https://api.github.com/users/baxterthehacker",
          "html_url": "https://github.com/baxterthehacker",
          "followers_url": "https://api.github.com/users/baxterthehacker/followers",
          "following_url": "https://api.github.com/users/baxterthehacker/following{/other_user}",
          "gists_url": "https://api.github.com/users/baxterthehacker/gists{/gist_id}",
          "starred_url": "https://api.github.com/users/baxterthehacker/starred{/owner}{/repo}",
          "subscriptions_url": "https://api.github.com/users/baxterthehacker/subscriptions",
          "organizations_url": "https://api.github.com/users/baxterthehacker/orgs",
          "repos_url": "https://api.github.com/users/baxterthehacker/repos",
          "events_url": "https://api.github.com/users/baxterthehacker/events{/privacy}",
          "received_events_url": "https://api.github.com/users/baxterthehacker/received_events",
          "type": "User",
          "site_admin": false
        },
        "private": false,
        "html_url": "https://github.com/baxterthehacker/public-repo",
        "description": "",
        "fork": false,
        "url": "https://api.github.com/repos/baxterthehacker/public-repo",
        "forks_url": "https://api.github.com/repos/baxterthehacker/public-repo/forks",
        "keys_url": "https://api.github.com/repos/baxterthehacker/public-repo/keys{/key_id}",
        "collaborators_url": "https://api.github.com/repos/baxterthehacker/public-repo/collaborators{/collaborator}",
        "teams_url": "https://api.github.com/repos/baxterthehacker/public-repo/teams",
        "hooks_url": "https://api.github.com/repos/baxterthehacker/public-repo/hooks",
        "issue_events_url": "https://api.github.com/repos/baxterthehacker/public-repo/issues/events{/number}",
        "events_url": "https://api.github.com/repos/baxterthehacker/public-repo/events",
        "assignees_url": "https://api.github.com/repos/baxterthehacker/public-repo/assignees{/user}",
        "branches_url": "https://api.github.com/repos/baxterthehacker/public-repo/branches{/branch}",
        "tags_url": "https://api.github.com/repos/baxterthehacker/public-repo/tags",
        "blobs_url": "https://api.github.com/repos/baxterthehacker/public-repo/git/blobs{/sha}",
        "git_tags_url": "https://api.github.com/repos/baxterthehacker/public-repo/git/tags{/sha}",
        "git_refs_url": "https://api.github.com/repos/baxterthehacker/public-repo/git/refs{/sha}",
        "trees_url": "https://api.github.com/repos/baxterthehacker/public-repo/git/trees{/sha}",
        "statuses_url": "https://api.github.com/repos/baxterthehacker/public-repo/statuses/{sha}",
        "languages_url": "https://api.github.com/repos/baxterthehacker/public-repo/languages",
        "stargazers_url": "https://api.github.com/repos/baxterthehacker/public-repo/stargazers",
        "contributors_url": "https://api.github.com/repos/baxterthehacker/public-repo/contributors",
        "subscribers_url": "https://api.github.com/repos/baxterthehacker/public-repo/subscribers",
        "subscription_url": "https://api.github.com/repos/baxterthehacker/public-repo/subscription",
        "commits_url": "https://api.github.com/repos/baxterthehacker/public-repo/commits{/sha}",
        "git_commits_url": "https://api.github.com/repos/baxterthehacker/public-repo/git/commits{/sha}",
        "comments_url": "https://api.github.com/repos/baxterthehacker/public-repo/comments{/number}",
        "issue_comment_url": "https://api.github.com/repos/baxterthehacker/public-repo/issues/comments{/number}",
        "contents_url": "https://api.github.com/repos/baxterthehacker/public-repo/contents/{+path}",
        "compare_url": "https://api.github.com/repos/baxterthehacker/public-repo/compare/{base}...{head}",
        "merges_url": "https://api.github.com/repos/baxterthehacker/public-repo/merges",
        "archive_url": "https://api.github.com/repos/baxterthehacker/public-repo/{archive_format}{/ref}",
        "downloads_url": "https://api.github.com/repos/baxterthehacker/public-repo/downloads",
        "issues_url": "https://api.github.com/repos/baxterthehacker/public-repo/issues{/number}",
        "pulls_url": "https://api.github.com/repos/baxterthehacker/public-repo/pulls{/number}",
        "milestones_url": "https://api.github.com/repos/baxterthehacker/public-repo/milestones{/number}",
        "notifications_url": "https://api.github.com/repos/baxterthehacker/public-repo/notifications{?since,all,participating}",
        "labels_url": "https://api.github.com/repos/baxterthehacker/public-repo/labels{/name}",
        "releases_url": "https://api.github.com/repos/baxterthehacker/public-repo/releases{/id}",
        "created_at": "2015-05-05T23:40:12Z",
        "updated_at": "2015-05-05T23:40:12Z",
        "pushed_at": "2015-05-05T23:40:26Z",
        "git_url": "git://github.com/baxterthehacker/public-repo.git",
        "ssh_url": "git@github.com:baxterthehacker/public-repo.git",
        "clone_url": "https://github.com/baxterthehacker/public-repo.git",
        "svn_url": "https://github.com/baxterthehacker/public-repo",
        "homepage": null,
        "size": 0,
        "stargazers_count": 0,
        "watchers_count": 0,
        "language": null,
        "has_issues": true,
        "has_downloads": true,
        "has_wiki": true,
        "has_pages": true,
        "forks_count": 0,
        "mirror_url": null,
        "open_issues_count": 1,
        "forks": 0,
        "open_issues": 1,
        "watchers": 0,
        "default_branch": "master"
      }
    },
    "base": {
      "label": "baxterthehacker:master",
      "ref": "master",
      "sha": "9049f1265b7d61be4a8904a9a27120d2064dab3b",
      "user": {
        "login": "baxterthehacker",
        "id": 6752317,
        "avatar_url": "https://avatars.githubusercontent.com/u/6752317?v=3",
        "gravatar_id": "",
        "url": "https://api.github.com/users/baxterthehacker",
        "html_url": "https://github.com/baxterthehacker",
        "followers_url": "https://api.github.com/users/baxterthehacker/followers",
        "following_url": "https://api.github.com/users/baxterthehacker/following{/other_user}",
        "gists_url": "https://api.github.com/users/baxterthehacker/gists{/gist_id}",
        "starred_url": "https://api.github.com/users/baxterthehacker/starred{/owner}{/repo}",
        "subscriptions_url": "https://api.github.com/users/baxterthehacker/subscriptions",
        "organizations_url": "https://api.github.com/users/baxterthehacker/orgs",
        "repos_url": "https://api.github.com/users/baxterthehacker/repos",
        "events_url": "https://api.github.com/users/baxterthehacker/events{/privacy}",
        "received_events_url": "https://api.github.com/users/baxterthehacker/received_events",
        "type": "User",
        "site_admin": false
      },
      "repo": {
        "id": 35129377,
        "name": "public-repo",
        "full_name": "baxterthehacker/public-repo",
        "owner": {
          "login": "baxterthehacker",
          "id": 6752317,
          "avatar_url": "https://avatars.githubusercontent.com/u/6752317?v=3",
          "gravatar_id": "",
          "url": "https://api.github.com/users/baxterthehacker",
          "html_url": "https://github.com/baxterthehacker",
          "followers_url": "https://api.github.com/users/baxterthehacker/followers",
          "following_url": "https://api.github.com/users/baxterthehacker/following{/other_user}",
          "gists_url": "https://api.github.com/users/baxterthehacker/gists{/gist_id}",
          "starred_url": "https://api.github.com/users/baxterthehacker/starred{/owner}{/repo}",
          "subscriptions_url": "https://api.github.com/users/baxterthehacker/subscriptions",
          "organizations_url": "https://api.github.com/users/baxterthehacker/orgs",
          "repos_url": "https://api.github.com/users/baxterthehacker/repos",
          "events_url": "https://api.github.com/users/baxterthehacker/events{/privacy}",
          "received_events_url": "https://api.github.com/users/baxterthehacker/received_events",
          "type": "User",
          "site_admin": false
        },
        "private": false,
        "html_url": "https://github.com/baxterthehacker/public-repo",
        "description": "",
        "fork": false,
        "url": "https://api.github.com/repos/baxterthehacker/public-repo",
        "forks_url": "https://api.github.com/repos/baxterthehacker/public-repo/forks",
        "keys_url": "https://api.github.com/repos/baxterthehacker/public-repo/keys{/key_id}",
        "collaborators_url": "https://api.github.com/repos/baxterthehacker/public-repo/collaborators{/collaborator}",
        "teams_url": "https://api.github.com/repos/baxterthehacker/public-repo/teams",
        "hooks_url": "https://api.github.com/repos/baxterthehacker/public-repo/hooks",
        "issue_events_url": "https://api.github.com/repos/baxterthehacker/public-repo/issues/events{/number}",
        "events_url": "https://api.github.com/repos/baxterthehacker/public-repo/events",
        "assignees_url": "https://api.github.com/repos/baxterthehacker/public-repo/assignees{/user}",
        "branches_url": "https://api.github.com/repos/baxterthehacker/public-repo/branches{/branch}",
        "tags_url": "https://api.github.com/repos/baxterthehacker/public-repo/tags",
        "blobs_url": "https://api.github.com/repos/baxterthehacker/public-repo/git/blobs{/sha}",
        "git_tags_url": "https://api.github.com/repos/baxterthehacker/public-repo/git/tags{/sha}",
        "git_refs_url": "https://api.github.com/repos/baxterthehacker/public-repo/git/refs{/sha}",
        "trees_url": "https://api.github.com/repos/baxterthehacker/public-repo/git/trees{/sha}",
        "statuses_url": "https://api.github.com/repos/baxterthehacker/public-repo/statuses/{sha}",
        "languages_url": "https://api.github.com/repos/baxterthehacker/public-repo/languages",
        "stargazers_url": "https://api.github.com/repos/baxterthehacker/public-repo/stargazers",
        "contributors_url": "https://api.github.com/repos/baxterthehacker/public-repo/contributors",
        "subscribers_url": "https://api.github.com/repos/baxterthehacker/public-repo/subscribers",
        "subscription_url": "https://api.github.com/repos/baxterthehacker/public-repo/subscription",
        "commits_url": "https://api.github.com/repos/baxterthehacker/public-repo/commits{/sha}",
        "git_commits_url": "https://api.github.com/repos/baxterthehacker/public-repo/git/commits{/sha}",
        "comments_url": "https://api.github.com/repos/baxterthehacker/public-repo/comments{/number}",
        "issue_comment_url": "https://api.github.com/repos/baxterthehacker/public-repo/issues/comments{/number}",
        "contents_url": "https://api.github.com/repos/baxterthehacker/public-repo/contents/{+path}",
        "compare_url": "https://api.github.com/repos/baxterthehacker/public-repo/compare/{base}...{head}",
        "merges_url": "https://api.github.com/repos/baxterthehacker/public-repo/merges",
        "archive_url": "https://api.github.com/repos/baxterthehacker/public-repo/{archive_format}{/ref}",
        "downloads_url": "https://api.github.com/repos/baxterthehacker/public-repo/downloads",
        "issues_url": "https://api.github.com/repos/baxterthehacker/public-repo/issues{/number}",
        "pulls_url": "https://api.github.com/repos/baxterthehacker/public-repo/pulls{/number}",
        "milestones_url": "https://api.github.com/repos/baxterthehacker/public-repo/milestones{/number}",
        "notifications_url": "https://api.github.com/repos/baxterthehacker/public-repo/notifications{?since,all,participating}",
        "labels_url": "https://api.github.com/repos/baxterthehacker/public-repo/labels{/name}",
        "releases_url": "https://api.github.com/repos/baxterthehacker/public-repo/releases{/id}",
        "created_at": "2015-05-05T23:40:12Z",
        "updated_at": "2015-05-05T23:40:12Z",
        "pushed_at": "2015-05-05T23:40:26Z",
        "git_url": "git://github.com/baxterthehacker/public-repo.git",
        "ssh_url": "git@github.com:baxterthehacker/public-repo.git",
        "clone_url": "https://github.com/baxterthehacker/public-repo.git",
        "svn_url": "https://github.com/baxterthehacker/public-repo",
        "homepage": null,
        "size": 0,
        "stargazers_count": 0,
        "watchers_count": 0,
        "language": null,
        "has_issues": true,
        "has_downloads": true,
        "has_wiki": true,
        "has_pages": true,
        "forks_count": 0,
        "mirror_url": null,
        "open_issues_count": 1,
        "forks": 0,
        "open_issues": 1,
        "watchers": 0,
        "default_branch": "master"
      }
    },
    "_links": {
      "self": {
        "href": "https://api.github.com/repos/baxterthehacker/public-repo/pulls/1"
      },
      "html": {
        "href": "https://github.com/baxterthehacker/public-repo/pull/1"
      },
      "issue": {
        "href": "https://api.github.com/repos/baxterthehacker/public-repo/issues/1"
      },
      "comments": {
        "href": "https://api.github.com/repos/baxterthehacker/public-repo/issues/1/comments"
      },
      "review_comments": {
        "href": "https://api.github.com/repos/baxterthehacker/public-repo/pulls/1/comments"
      },
      "review_comment": {
        "href": "https://api.github.com/repos/baxterthehacker/public-repo/pulls/comments{/number}"
      },
      "commits": {
        "href": "https://api.github.com/repos/baxterthehacker/public-repo/pulls/1/commits"
      },
      "statuses": {
        "href": "https://api.github.com/repos/baxterthehacker/public-repo/statuses/0d1a26e67d8f5eaf1f6ba5c57fc3c7d91ac0fd1c"
      }
    },
    "merged": false,
    "mergeable": null,
    "mergeable_state": "unknown",
    "merged_by": null,
    "comments": 0,
    "review_comments": 0,
    "commits": 1,
    "additions": 1,
    "deletions": 1,
    "changed_files": 1
  },
  "repository": {
    "id": 35129377,
    "name": "public-repo",
    "full_name": "baxterthehacker/public-repo",
    "owner": {
      "login": "baxterthehacker",
      "id": 6752317,
      "avatar_url": "https://avatars.githubusercontent.com/u/6752317?v=3",
      "gravatar_id": "",
      "url": "https://api.github.com/users/baxterthehacker",
      "html_url": "https://github.com/baxterthehacker",
      "followers_url": "https://api.github.com/users/baxterthehacker/followers",
      "following_url": "https://api.github.com/users/baxterthehacker/following{/other_user}",
      "gists_url": "https://api.github.com/users/baxterthehacker/gists{/gist_id}",
      "starred_url": "https://api.github.com/users/baxterthehacker/starred{/owner}{/repo}",
      "subscriptions_url": "https://api.github.com/users/baxterthehacker/subscriptions",
      "organizations_url": "https://api.github.com/users/baxterthehacker/orgs",
      "repos_url": "https://api.github.com/users/baxterthehacker/repos",
      "events_url": "https://api.github.com/users/baxterthehacker/events{/privacy}",
      "received_events_url": "https://api.github.com/users/baxterthehacker/received_events",
      "type": "User",
      "site_admin": false
    },
    "private": false,
    "html_url": "https://github.com/baxterthehacker/public-repo",
    "description": "",
    "fork": false,
    "url": "https://api.github.com/repos/baxterthehacker/public-repo",
    "forks_url": "https://api.github.com/repos/baxterthehacker/public-repo/forks",
    "keys_url": "https://api.github.com/repos/baxterthehacker/public-repo/keys{/key_id}",
    "collaborators_url": "https://api.github.com/repos/baxterthehacker/public-repo/collaborators{/collaborator}",
    "teams_url": "https://api.github.com/repos/baxterthehacker/public-repo/teams",
    "hooks_url": "https://api.github.com/repos/baxterthehacker/public-repo/hooks",
    "issue_events_url": "https://api.github.com/repos/baxterthehacker/public-repo/issues/events{/number}",
    "events_url": "https://api.github.com/repos/baxterthehacker/public-repo/events",
    "assignees_url": "https://api.github.com/repos/baxterthehacker/public-repo/assignees{/user}",
    "branches_url": "https://api.github.com/repos/baxterthehacker/public-repo/branches{/branch}",
    "tags_url": "https://api.github.com/repos/baxterthehacker/public-repo/tags",
    "blobs_url": "https://api.github.com/repos/baxterthehacker/public-repo/git/blobs{/sha}",
    "git_tags_url": "https://api.github.com/repos/baxterthehacker/public-repo/git/tags{/sha}",
    "git_refs_url": "https://api.github.com/repos/baxterthehacker/public-repo/git/refs{/sha}",
    "trees_url": "https://api.github.com/repos/baxterthehacker/public-repo/git/trees{/sha}",
    "statuses_url": "https://api.github.com/repos/baxterthehacker/public-repo/statuses/{sha}",
    "languages_url": "https://api.github.com/repos/baxterthehacker/public-repo/languages",
    "stargazers_url": "https://api.github.com/repos/baxterthehacker/public-repo/stargazers",
    "contributors_url": "https://api.github.com/repos/baxterthehacker/public-repo/contributors",
    "subscribers_url": "https://api.github.com/repos/baxterthehacker/public-repo/subscribers",
    "subscription_url": "https://api.github.com/repos/baxterthehacker/public-repo/subscription",
    "commits_url": "https://api.github.com/repos/baxterthehacker/public-repo/commits{/sha}",
    "git_commits_url": "https://api.github.com/repos/baxterthehacker/public-repo/git/commits{/sha}",
    "comments_url": "https://api.github.com/repos/baxterthehacker/public-repo/comments{/number}",
    "issue_comment_url": "https://api.github.com/repos/baxterthehacker/public-repo/issues/comments{/number}",
    "contents_url": "https://api.github.com/repos/baxterthehacker/public-repo/contents/{+path}",
    "compare_url": "https://api.github.com/repos/baxterthehacker/public-repo/compare/{base}...{head}",
    "merges_url": "https://api.github.com/repos/baxterthehacker/public-repo/merges",
    "archive_url": "https://api.github.com/repos/baxterthehacker/public-repo/{archive_format}{/ref}",
    "downloads_url": "https://api.github.com/repos/baxterthehacker/public-repo/downloads",
    "issues_url": "https://api.github.com/repos/baxterthehacker/public-repo/issues{/number}",
    "pulls_url": "https://api.github.com/repos/baxterthehacker/public-repo/pulls{/number}",
    "milestones_url": "https://api.github.com/repos/baxterthehacker/public-repo/milestones{/number}",
    "notifications_url": "https://api.github.com/repos/baxterthehacker/public-repo/notifications{?since,all,participating}",
    "labels_url": "https://api.github.com/repos/baxterthehacker/public-repo/labels{/name}",
    "releases_url": "https://api.github.com/repos/baxterthehacker/public-repo/releases{/id}",
    "created_at": "2015-05-05T23:40:12Z",
    "updated_at": "2015-05-05T23:40:12Z",
    "pushed_at": "2015-05-05T23:40:26Z",
    "git_url": "git://github.com/baxterthehacker/public-repo.git",
    "ssh_url": "git@github.com:baxterthehacker/public-repo.git",
    "clone_url": "https://github.com/baxterthehacker/public-repo.git",
    "svn_url": "https://github.com/baxterthehacker/public-repo",
    "homepage": null,
    "size": 0,
    "stargazers_count": 0,
    "watchers_count": 0,
    "language": null,
    "has_issues": true,
    "has_downloads": true,
    "has_wiki": true,
    "has_pages": true,
    "forks_count": 0,
    "mirror_url": null,
    "open_issues_count": 1,
    "forks": 0,
    "open_issues": 1,
    "watchers": 0,
    "default_branch": "master"
  },
  "sender": {
    "login": "baxterthehacker",
    "id": 6752317,
    "avatar_url": "https://avatars.githubusercontent.com/u/6752317?v=3",
    "gravatar_id": "",
    "url": "https://api.github.com/users/baxterthehacker",
    "html_url": "https://github.com/baxterthehacker",
    "followers_url": "https://api.github.com/users/baxterthehacker/followers",
    "following_url": "https://api.github.com/users/baxterthehacker/following{/other_user}",
    "gists_url": "https://api.github.com/users/baxterthehacker/gists{/gist_id}",
    "starred_url": "https://api.github.com/users/baxterthehacker/starred{/owner}{/repo}",
    "subscriptions_url": "https://api.github.com/users/baxterthehacker/subscriptions",
    "organizations_url": "https://api.github.com/users/baxterthehacker/orgs",
    "repos_url": "https://api.github.com/users/baxterthehacker/repos",
    "events_url": "https://api.github.com/users/baxterthehacker/events{/privacy}",
    "received_events_url": "https://api.github.com/users/baxterthehacker/received_events",
    "type": "User",
    "site_admin": false
  },
  "installation": {
    "id": 234
  }
}

PullRequestReviewEvent

Triggered when a pull request review is submitted into a non-pending state, the body is edited, or the review is dismissed.

Events API Payload

Key Type Description
action string The action that was performed. Can be "submitted", "edited", or "dismissed".
pull_request object The pull request the review pertains to.
review object The review that was affected.
changes[body][from] string The previous version of the body if the action was "edited".

Webhook event name

pull_request_review

Webhook payload example

{
  "action": "submitted",
  "review": {
    "id": 2626884,
    "user": {
      "login": "baxterthehacker",
      "id": 6752317,
      "avatar_url": "https://avatars.githubusercontent.com/u/6752317?v=3",
      "gravatar_id": "",
      "url": "https://api.github.com/users/baxterthehacker",
      "html_url": "https://github.com/baxterthehacker",
      "followers_url": "https://api.github.com/users/baxterthehacker/followers",
      "following_url": "https://api.github.com/users/baxterthehacker/following{/other_user}",
      "gists_url": "https://api.github.com/users/baxterthehacker/gists{/gist_id}",
      "starred_url": "https://api.github.com/users/baxterthehacker/starred{/owner}{/repo}",
      "subscriptions_url": "https://api.github.com/users/baxterthehacker/subscriptions",
      "organizations_url": "https://api.github.com/users/baxterthehacker/orgs",
      "repos_url": "https://api.github.com/users/baxterthehacker/repos",
      "events_url": "https://api.github.com/users/baxterthehacker/events{/privacy}",
      "received_events_url": "https://api.github.com/users/baxterthehacker/received_events",
      "type": "User",
      "site_admin": false
    },
    "body": "Looks great!",
    "submitted_at": "2016-10-03T23:39:09Z",
    "state": "approved",
    "html_url": "https://github.com/baxterthehacker/public-repo/pull/8#pullrequestreview-2626884",
    "pull_request_url": "https://api.github.com/repos/baxterthehacker/public-repo/pulls/8",
    "_links": {
      "html": {
        "href": "https://github.com/baxterthehacker/public-repo/pull/8#pullrequestreview-2626884"
      },
      "pull_request": {
        "href": "https://api.github.com/repos/baxterthehacker/public-repo/pulls/8"
      }
    }
  },
  "pull_request": {
    "url": "https://api.github.com/repos/baxterthehacker/public-repo/pulls/8",
    "id": 87811438,
    "html_url": "https://github.com/baxterthehacker/public-repo/pull/8",
    "diff_url": "https://github.com/baxterthehacker/public-repo/pull/8.diff",
    "patch_url": "https://github.com/baxterthehacker/public-repo/pull/8.patch",
    "issue_url": "https://api.github.com/repos/baxterthehacker/public-repo/issues/8",
    "number": 8,
    "state": "open",
    "locked": false,
    "title": "Add a README description",
    "user": {
      "login": "skalnik",
      "id": 2546,
      "avatar_url": "https://avatars.githubusercontent.com/u/2546?v=3",
      "gravatar_id": "",
      "url": "https://api.github.com/users/skalnik",
      "html_url": "https://github.com/skalnik",
      "followers_url": "https://api.github.com/users/skalnik/followers",
      "following_url": "https://api.github.com/users/skalnik/following{/other_user}",
      "gists_url": "https://api.github.com/users/skalnik/gists{/gist_id}",
      "starred_url": "https://api.github.com/users/skalnik/starred{/owner}{/repo}",
      "subscriptions_url": "https://api.github.com/users/skalnik/subscriptions",
      "organizations_url": "https://api.github.com/users/skalnik/orgs",
      "repos_url": "https://api.github.com/users/skalnik/repos",
      "events_url": "https://api.github.com/users/skalnik/events{/privacy}",
      "received_events_url": "https://api.github.com/users/skalnik/received_events",
      "type": "User",
      "site_admin": true
    },
    "body": "Just a few more details",
    "created_at": "2016-10-03T23:37:43Z",
    "updated_at": "2016-10-03T23:39:09Z",
    "closed_at": null,
    "merged_at": null,
    "merge_commit_sha": "faea154a7decef6819754aab0f8c0e232e6c8b4f",
    "assignee": null,
    "assignees": [],
    "milestone": null,
    "commits_url": "https://api.github.com/repos/baxterthehacker/public-repo/pulls/8/commits",
    "review_comments_url": "https://api.github.com/repos/baxterthehacker/public-repo/pulls/8/comments",
    "review_comment_url": "https://api.github.com/repos/baxterthehacker/public-repo/pulls/comments{/number}",
    "comments_url": "https://api.github.com/repos/baxterthehacker/public-repo/issues/8/comments",
    "statuses_url": "https://api.github.com/repos/baxterthehacker/public-repo/statuses/b7a1f9c27caa4e03c14a88feb56e2d4f7500aa63",
    "head": {
      "label": "skalnik:patch-2",
      "ref": "patch-2",
      "sha": "b7a1f9c27caa4e03c14a88feb56e2d4f7500aa63",
      "user": {
        "login": "skalnik",
        "id": 2546,
        "avatar_url": "https://avatars.githubusercontent.com/u/2546?v=3",
        "gravatar_id": "",
        "url": "https://api.github.com/users/skalnik",
        "html_url": "https://github.com/skalnik",
        "followers_url": "https://api.github.com/users/skalnik/followers",
        "following_url": "https://api.github.com/users/skalnik/following{/other_user}",
        "gists_url": "https://api.github.com/users/skalnik/gists{/gist_id}",
        "starred_url": "https://api.github.com/users/skalnik/starred{/owner}{/repo}",
        "subscriptions_url": "https://api.github.com/users/skalnik/subscriptions",
        "organizations_url": "https://api.github.com/users/skalnik/orgs",
        "repos_url": "https://api.github.com/users/skalnik/repos",
        "events_url": "https://api.github.com/users/skalnik/events{/privacy}",
        "received_events_url": "https://api.github.com/users/skalnik/received_events",
        "type": "User",
        "site_admin": true
      },
      "repo": {
        "id": 69919152,
        "name": "public-repo",
        "full_name": "skalnik/public-repo",
        "owner": {
          "login": "skalnik",
          "id": 2546,
          "avatar_url": "https://avatars.githubusercontent.com/u/2546?v=3",
          "gravatar_id": "",
          "url": "https://api.github.com/users/skalnik",
          "html_url": "https://github.com/skalnik",
          "followers_url": "https://api.github.com/users/skalnik/followers",
          "following_url": "https://api.github.com/users/skalnik/following{/other_user}",
          "gists_url": "https://api.github.com/users/skalnik/gists{/gist_id}",
          "starred_url": "https://api.github.com/users/skalnik/starred{/owner}{/repo}",
          "subscriptions_url": "https://api.github.com/users/skalnik/subscriptions",
          "organizations_url": "https://api.github.com/users/skalnik/orgs",
          "repos_url": "https://api.github.com/users/skalnik/repos",
          "events_url": "https://api.github.com/users/skalnik/events{/privacy}",
          "received_events_url": "https://api.github.com/users/skalnik/received_events",
          "type": "User",
          "site_admin": true
        },
        "private": false,
        "html_url": "https://github.com/skalnik/public-repo",
        "description": null,
        "fork": true,
        "url": "https://api.github.com/repos/skalnik/public-repo",
        "forks_url": "https://api.github.com/repos/skalnik/public-repo/forks",
        "keys_url": "https://api.github.com/repos/skalnik/public-repo/keys{/key_id}",
        "collaborators_url": "https://api.github.com/repos/skalnik/public-repo/collaborators{/collaborator}",
        "teams_url": "https://api.github.com/repos/skalnik/public-repo/teams",
        "hooks_url": "https://api.github.com/repos/skalnik/public-repo/hooks",
        "issue_events_url": "https://api.github.com/repos/skalnik/public-repo/issues/events{/number}",
        "events_url": "https://api.github.com/repos/skalnik/public-repo/events",
        "assignees_url": "https://api.github.com/repos/skalnik/public-repo/assignees{/user}",
        "branches_url": "https://api.github.com/repos/skalnik/public-repo/branches{/branch}",
        "tags_url": "https://api.github.com/repos/skalnik/public-repo/tags",
        "blobs_url": "https://api.github.com/repos/skalnik/public-repo/git/blobs{/sha}",
        "git_tags_url": "https://api.github.com/repos/skalnik/public-repo/git/tags{/sha}",
        "git_refs_url": "https://api.github.com/repos/skalnik/public-repo/git/refs{/sha}",
        "trees_url": "https://api.github.com/repos/skalnik/public-repo/git/trees{/sha}",
        "statuses_url": "https://api.github.com/repos/skalnik/public-repo/statuses/{sha}",
        "languages_url": "https://api.github.com/repos/skalnik/public-repo/languages",
        "stargazers_url": "https://api.github.com/repos/skalnik/public-repo/stargazers",
        "contributors_url": "https://api.github.com/repos/skalnik/public-repo/contributors",
        "subscribers_url": "https://api.github.com/repos/skalnik/public-repo/subscribers",
        "subscription_url": "https://api.github.com/repos/skalnik/public-repo/subscription",
        "commits_url": "https://api.github.com/repos/skalnik/public-repo/commits{/sha}",
        "git_commits_url": "https://api.github.com/repos/skalnik/public-repo/git/commits{/sha}",
        "comments_url": "https://api.github.com/repos/skalnik/public-repo/comments{/number}",
        "issue_comment_url": "https://api.github.com/repos/skalnik/public-repo/issues/comments{/number}",
        "contents_url": "https://api.github.com/repos/skalnik/public-repo/contents/{+path}",
        "compare_url": "https://api.github.com/repos/skalnik/public-repo/compare/{base}...{head}",
        "merges_url": "https://api.github.com/repos/skalnik/public-repo/merges",
        "archive_url": "https://api.github.com/repos/skalnik/public-repo/{archive_format}{/ref}",
        "downloads_url": "https://api.github.com/repos/skalnik/public-repo/downloads",
        "issues_url": "https://api.github.com/repos/skalnik/public-repo/issues{/number}",
        "pulls_url": "https://api.github.com/repos/skalnik/public-repo/pulls{/number}",
        "milestones_url": "https://api.github.com/repos/skalnik/public-repo/milestones{/number}",
        "notifications_url": "https://api.github.com/repos/skalnik/public-repo/notifications{?since,all,participating}",
        "labels_url": "https://api.github.com/repos/skalnik/public-repo/labels{/name}",
        "releases_url": "https://api.github.com/repos/skalnik/public-repo/releases{/id}",
        "deployments_url": "https://api.github.com/repos/skalnik/public-repo/deployments",
        "created_at": "2016-10-03T23:23:31Z",
        "updated_at": "2016-08-15T17:19:01Z",
        "pushed_at": "2016-10-03T23:36:52Z",
        "git_url": "git://github.com/skalnik/public-repo.git",
        "ssh_url": "git@github.com:skalnik/public-repo.git",
        "clone_url": "https://github.com/skalnik/public-repo.git",
        "svn_url": "https://github.com/skalnik/public-repo",
        "homepage": null,
        "size": 233,
        "stargazers_count": 0,
        "watchers_count": 0,
        "language": null,
        "has_issues": false,
        "has_downloads": true,
        "has_wiki": true,
        "has_pages": false,
        "forks_count": 0,
        "mirror_url": null,
        "open_issues_count": 0,
        "forks": 0,
        "open_issues": 0,
        "watchers": 0,
        "default_branch": "master"
      }
    },
    "base": {
      "label": "baxterthehacker:master",
      "ref": "master",
      "sha": "9049f1265b7d61be4a8904a9a27120d2064dab3b",
      "user": {
        "login": "baxterthehacker",
        "id": 6752317,
        "avatar_url": "https://avatars.githubusercontent.com/u/6752317?v=3",
        "gravatar_id": "",
        "url": "https://api.github.com/users/baxterthehacker",
        "html_url": "https://github.com/baxterthehacker",
        "followers_url": "https://api.github.com/users/baxterthehacker/followers",
        "following_url": "https://api.github.com/users/baxterthehacker/following{/other_user}",
        "gists_url": "https://api.github.com/users/baxterthehacker/gists{/gist_id}",
        "starred_url": "https://api.github.com/users/baxterthehacker/starred{/owner}{/repo}",
        "subscriptions_url": "https://api.github.com/users/baxterthehacker/subscriptions",
        "organizations_url": "https://api.github.com/users/baxterthehacker/orgs",
        "repos_url": "https://api.github.com/users/baxterthehacker/repos",
        "events_url": "https://api.github.com/users/baxterthehacker/events{/privacy}",
        "received_events_url": "https://api.github.com/users/baxterthehacker/received_events",
        "type": "User",
        "site_admin": false
      },
      "repo": {
        "id": 35129377,
        "name": "public-repo",
        "full_name": "baxterthehacker/public-repo",
        "owner": {
          "login": "baxterthehacker",
          "id": 6752317,
          "avatar_url": "https://avatars.githubusercontent.com/u/6752317?v=3",
          "gravatar_id": "",
          "url": "https://api.github.com/users/baxterthehacker",
          "html_url": "https://github.com/baxterthehacker",
          "followers_url": "https://api.github.com/users/baxterthehacker/followers",
          "following_url": "https://api.github.com/users/baxterthehacker/following{/other_user}",
          "gists_url": "https://api.github.com/users/baxterthehacker/gists{/gist_id}",
          "starred_url": "https://api.github.com/users/baxterthehacker/starred{/owner}{/repo}",
          "subscriptions_url": "https://api.github.com/users/baxterthehacker/subscriptions",
          "organizations_url": "https://api.github.com/users/baxterthehacker/orgs",
          "repos_url": "https://api.github.com/users/baxterthehacker/repos",
          "events_url": "https://api.github.com/users/baxterthehacker/events{/privacy}",
          "received_events_url": "https://api.github.com/users/baxterthehacker/received_events",
          "type": "User",
          "site_admin": false
        },
        "private": false,
        "html_url": "https://github.com/baxterthehacker/public-repo",
        "description": "",
        "fork": false,
        "url": "https://api.github.com/repos/baxterthehacker/public-repo",
        "forks_url": "https://api.github.com/repos/baxterthehacker/public-repo/forks",
        "keys_url": "https://api.github.com/repos/baxterthehacker/public-repo/keys{/key_id}",
        "collaborators_url": "https://api.github.com/repos/baxterthehacker/public-repo/collaborators{/collaborator}",
        "teams_url": "https://api.github.com/repos/baxterthehacker/public-repo/teams",
        "hooks_url": "https://api.github.com/repos/baxterthehacker/public-repo/hooks",
        "issue_events_url": "https://api.github.com/repos/baxterthehacker/public-repo/issues/events{/number}",
        "events_url": "https://api.github.com/repos/baxterthehacker/public-repo/events",
        "assignees_url": "https://api.github.com/repos/baxterthehacker/public-repo/assignees{/user}",
        "branches_url": "https://api.github.com/repos/baxterthehacker/public-repo/branches{/branch}",
        "tags_url": "https://api.github.com/repos/baxterthehacker/public-repo/tags",
        "blobs_url": "https://api.github.com/repos/baxterthehacker/public-repo/git/blobs{/sha}",
        "git_tags_url": "https://api.github.com/repos/baxterthehacker/public-repo/git/tags{/sha}",
        "git_refs_url": "https://api.github.com/repos/baxterthehacker/public-repo/git/refs{/sha}",
        "trees_url": "https://api.github.com/repos/baxterthehacker/public-repo/git/trees{/sha}",
        "statuses_url": "https://api.github.com/repos/baxterthehacker/public-repo/statuses/{sha}",
        "languages_url": "https://api.github.com/repos/baxterthehacker/public-repo/languages",
        "stargazers_url": "https://api.github.com/repos/baxterthehacker/public-repo/stargazers",
        "contributors_url": "https://api.github.com/repos/baxterthehacker/public-repo/contributors",
        "subscribers_url": "https://api.github.com/repos/baxterthehacker/public-repo/subscribers",
        "subscription_url": "https://api.github.com/repos/baxterthehacker/public-repo/subscription",
        "commits_url": "https://api.github.com/repos/baxterthehacker/public-repo/commits{/sha}",
        "git_commits_url": "https://api.github.com/repos/baxterthehacker/public-repo/git/commits{/sha}",
        "comments_url": "https://api.github.com/repos/baxterthehacker/public-repo/comments{/number}",
        "issue_comment_url": "https://api.github.com/repos/baxterthehacker/public-repo/issues/comments{/number}",
        "contents_url": "https://api.github.com/repos/baxterthehacker/public-repo/contents/{+path}",
        "compare_url": "https://api.github.com/repos/baxterthehacker/public-repo/compare/{base}...{head}",
        "merges_url": "https://api.github.com/repos/baxterthehacker/public-repo/merges",
        "archive_url": "https://api.github.com/repos/baxterthehacker/public-repo/{archive_format}{/ref}",
        "downloads_url": "https://api.github.com/repos/baxterthehacker/public-repo/downloads",
        "issues_url": "https://api.github.com/repos/baxterthehacker/public-repo/issues{/number}",
        "pulls_url": "https://api.github.com/repos/baxterthehacker/public-repo/pulls{/number}",
        "milestones_url": "https://api.github.com/repos/baxterthehacker/public-repo/milestones{/number}",
        "notifications_url": "https://api.github.com/repos/baxterthehacker/public-repo/notifications{?since,all,participating}",
        "labels_url": "https://api.github.com/repos/baxterthehacker/public-repo/labels{/name}",
        "releases_url": "https://api.github.com/repos/baxterthehacker/public-repo/releases{/id}",
        "deployments_url": "https://api.github.com/repos/baxterthehacker/public-repo/deployments",
        "created_at": "2015-05-05T23:40:12Z",
        "updated_at": "2016-08-15T17:19:01Z",
        "pushed_at": "2016-10-03T23:37:43Z",
        "git_url": "git://github.com/baxterthehacker/public-repo.git",
        "ssh_url": "git@github.com:baxterthehacker/public-repo.git",
        "clone_url": "https://github.com/baxterthehacker/public-repo.git",
        "svn_url": "https://github.com/baxterthehacker/public-repo",
        "homepage": null,
        "size": 233,
        "stargazers_count": 2,
        "watchers_count": 2,
        "language": null,
        "has_issues": true,
        "has_downloads": true,
        "has_wiki": true,
        "has_pages": true,
        "forks_count": 2,
        "mirror_url": null,
        "open_issues_count": 5,
        "forks": 2,
        "open_issues": 5,
        "watchers": 2,
        "default_branch": "master"
      }
    },
    "_links": {
      "self": {
        "href": "https://api.github.com/repos/baxterthehacker/public-repo/pulls/8"
      },
      "html": {
        "href": "https://github.com/baxterthehacker/public-repo/pull/8"
      },
      "issue": {
        "href": "https://api.github.com/repos/baxterthehacker/public-repo/issues/8"
      },
      "comments": {
        "href": "https://api.github.com/repos/baxterthehacker/public-repo/issues/8/comments"
      },
      "review_comments": {
        "href": "https://api.github.com/repos/baxterthehacker/public-repo/pulls/8/comments"
      },
      "review_comment": {
        "href": "https://api.github.com/repos/baxterthehacker/public-repo/pulls/comments{/number}"
      },
      "commits": {
        "href": "https://api.github.com/repos/baxterthehacker/public-repo/pulls/8/commits"
      },
      "statuses": {
        "href": "https://api.github.com/repos/baxterthehacker/public-repo/statuses/b7a1f9c27caa4e03c14a88feb56e2d4f7500aa63"
      }
    }
  },
  "repository": {
    "id": 35129377,
    "name": "public-repo",
    "full_name": "baxterthehacker/public-repo",
    "owner": {
      "login": "baxterthehacker",
      "id": 6752317,
      "avatar_url": "https://avatars.githubusercontent.com/u/6752317?v=3",
      "gravatar_id": "",
      "url": "https://api.github.com/users/baxterthehacker",
      "html_url": "https://github.com/baxterthehacker",
      "followers_url": "https://api.github.com/users/baxterthehacker/followers",
      "following_url": "https://api.github.com/users/baxterthehacker/following{/other_user}",
      "gists_url": "https://api.github.com/users/baxterthehacker/gists{/gist_id}",
      "starred_url": "https://api.github.com/users/baxterthehacker/starred{/owner}{/repo}",
      "subscriptions_url": "https://api.github.com/users/baxterthehacker/subscriptions",
      "organizations_url": "https://api.github.com/users/baxterthehacker/orgs",
      "repos_url": "https://api.github.com/users/baxterthehacker/repos",
      "events_url": "https://api.github.com/users/baxterthehacker/events{/privacy}",
      "received_events_url": "https://api.github.com/users/baxterthehacker/received_events",
      "type": "User",
      "site_admin": false
    },
    "private": false,
    "html_url": "https://github.com/baxterthehacker/public-repo",
    "description": "",
    "fork": false,
    "url": "https://api.github.com/repos/baxterthehacker/public-repo",
    "forks_url": "https://api.github.com/repos/baxterthehacker/public-repo/forks",
    "keys_url": "https://api.github.com/repos/baxterthehacker/public-repo/keys{/key_id}",
    "collaborators_url": "https://api.github.com/repos/baxterthehacker/public-repo/collaborators{/collaborator}",
    "teams_url": "https://api.github.com/repos/baxterthehacker/public-repo/teams",
    "hooks_url": "https://api.github.com/repos/baxterthehacker/public-repo/hooks",
    "issue_events_url": "https://api.github.com/repos/baxterthehacker/public-repo/issues/events{/number}",
    "events_url": "https://api.github.com/repos/baxterthehacker/public-repo/events",
    "assignees_url": "https://api.github.com/repos/baxterthehacker/public-repo/assignees{/user}",
    "branches_url": "https://api.github.com/repos/baxterthehacker/public-repo/branches{/branch}",
    "tags_url": "https://api.github.com/repos/baxterthehacker/public-repo/tags",
    "blobs_url": "https://api.github.com/repos/baxterthehacker/public-repo/git/blobs{/sha}",
    "git_tags_url": "https://api.github.com/repos/baxterthehacker/public-repo/git/tags{/sha}",
    "git_refs_url": "https://api.github.com/repos/baxterthehacker/public-repo/git/refs{/sha}",
    "trees_url": "https://api.github.com/repos/baxterthehacker/public-repo/git/trees{/sha}",
    "statuses_url": "https://api.github.com/repos/baxterthehacker/public-repo/statuses/{sha}",
    "languages_url": "https://api.github.com/repos/baxterthehacker/public-repo/languages",
    "stargazers_url": "https://api.github.com/repos/baxterthehacker/public-repo/stargazers",
    "contributors_url": "https://api.github.com/repos/baxterthehacker/public-repo/contributors",
    "subscribers_url": "https://api.github.com/repos/baxterthehacker/public-repo/subscribers",
    "subscription_url": "https://api.github.com/repos/baxterthehacker/public-repo/subscription",
    "commits_url": "https://api.github.com/repos/baxterthehacker/public-repo/commits{/sha}",
    "git_commits_url": "https://api.github.com/repos/baxterthehacker/public-repo/git/commits{/sha}",
    "comments_url": "https://api.github.com/repos/baxterthehacker/public-repo/comments{/number}",
    "issue_comment_url": "https://api.github.com/repos/baxterthehacker/public-repo/issues/comments{/number}",
    "contents_url": "https://api.github.com/repos/baxterthehacker/public-repo/contents/{+path}",
    "compare_url": "https://api.github.com/repos/baxterthehacker/public-repo/compare/{base}...{head}",
    "merges_url": "https://api.github.com/repos/baxterthehacker/public-repo/merges",
    "archive_url": "https://api.github.com/repos/baxterthehacker/public-repo/{archive_format}{/ref}",
    "downloads_url": "https://api.github.com/repos/baxterthehacker/public-repo/downloads",
    "issues_url": "https://api.github.com/repos/baxterthehacker/public-repo/issues{/number}",
    "pulls_url": "https://api.github.com/repos/baxterthehacker/public-repo/pulls{/number}",
    "milestones_url": "https://api.github.com/repos/baxterthehacker/public-repo/milestones{/number}",
    "notifications_url": "https://api.github.com/repos/baxterthehacker/public-repo/notifications{?since,all,participating}",
    "labels_url": "https://api.github.com/repos/baxterthehacker/public-repo/labels{/name}",
    "releases_url": "https://api.github.com/repos/baxterthehacker/public-repo/releases{/id}",
    "deployments_url": "https://api.github.com/repos/baxterthehacker/public-repo/deployments",
    "created_at": "2015-05-05T23:40:12Z",
    "updated_at": "2016-08-15T17:19:01Z",
    "pushed_at": "2016-10-03T23:37:43Z",
    "git_url": "git://github.com/baxterthehacker/public-repo.git",
    "ssh_url": "git@github.com:baxterthehacker/public-repo.git",
    "clone_url": "https://github.com/baxterthehacker/public-repo.git",
    "svn_url": "https://github.com/baxterthehacker/public-repo",
    "homepage": null,
    "size": 233,
    "stargazers_count": 2,
    "watchers_count": 2,
    "language": null,
    "has_issues": true,
    "has_downloads": true,
    "has_wiki": true,
    "has_pages": true,
    "forks_count": 2,
    "mirror_url": null,
    "open_issues_count": 5,
    "forks": 2,
    "open_issues": 5,
    "watchers": 2,
    "default_branch": "master"
  },
  "sender": {
    "login": "baxterthehacker",
    "id": 6752317,
    "avatar_url": "https://avatars.githubusercontent.com/u/6752317?v=3",
    "gravatar_id": "",
    "url": "https://api.github.com/users/baxterthehacker",
    "html_url": "https://github.com/baxterthehacker",
    "followers_url": "https://api.github.com/users/baxterthehacker/followers",
    "following_url": "https://api.github.com/users/baxterthehacker/following{/other_user}",
    "gists_url": "https://api.github.com/users/baxterthehacker/gists{/gist_id}",
    "starred_url": "https://api.github.com/users/baxterthehacker/starred{/owner}{/repo}",
    "subscriptions_url": "https://api.github.com/users/baxterthehacker/subscriptions",
    "organizations_url": "https://api.github.com/users/baxterthehacker/orgs",
    "repos_url": "https://api.github.com/users/baxterthehacker/repos",
    "events_url": "https://api.github.com/users/baxterthehacker/events{/privacy}",
    "received_events_url": "https://api.github.com/users/baxterthehacker/received_events",
    "type": "User",
    "site_admin": false
  }
}

PullRequestReviewCommentEvent

Triggered when a comment on a pull request's unified diff is created, edited, or deleted (in the Files Changed tab).

Events API payload

Key Type Description
action string The action that was performed on the comment. Can be one of "created", "edited", or "deleted".
changes object The changes to the comment if the action was "edited".
changes[body][from] string The previous version of the body if the action was "edited".
pull_request object The pull request the comment belongs to.
comment object The comment itself.

Webhook event name

pull_request_review_comment

Webhook payload example

{
  "action": "created",
  "comment": {
    "url": "https://api.github.com/repos/baxterthehacker/public-repo/pulls/comments/29724692",
    "id": 29724692,
    "diff_hunk": "@@ -1 +1 @@\n-# public-repo",
    "path": "README.md",
    "position": 1,
    "original_position": 1,
    "commit_id": "0d1a26e67d8f5eaf1f6ba5c57fc3c7d91ac0fd1c",
    "original_commit_id": "0d1a26e67d8f5eaf1f6ba5c57fc3c7d91ac0fd1c",
    "user": {
      "login": "baxterthehacker",
      "id": 6752317,
      "avatar_url": "https://avatars.githubusercontent.com/u/6752317?v=3",
      "gravatar_id": "",
      "url": "https://api.github.com/users/baxterthehacker",
      "html_url": "https://github.com/baxterthehacker",
      "followers_url": "https://api.github.com/users/baxterthehacker/followers",
      "following_url": "https://api.github.com/users/baxterthehacker/following{/other_user}",
      "gists_url": "https://api.github.com/users/baxterthehacker/gists{/gist_id}",
      "starred_url": "https://api.github.com/users/baxterthehacker/starred{/owner}{/repo}",
      "subscriptions_url": "https://api.github.com/users/baxterthehacker/subscriptions",
      "organizations_url": "https://api.github.com/users/baxterthehacker/orgs",
      "repos_url": "https://api.github.com/users/baxterthehacker/repos",
      "events_url": "https://api.github.com/users/baxterthehacker/events{/privacy}",
      "received_events_url": "https://api.github.com/users/baxterthehacker/received_events",
      "type": "User",
      "site_admin": false
    },
    "body": "Maybe you should use more emojji on this line.",
    "created_at": "2015-05-05T23:40:27Z",
    "updated_at": "2015-05-05T23:40:27Z",
    "html_url": "https://github.com/baxterthehacker/public-repo/pull/1#discussion_r29724692",
    "pull_request_url": "https://api.github.com/repos/baxterthehacker/public-repo/pulls/1",
    "_links": {
      "self": {
        "href": "https://api.github.com/repos/baxterthehacker/public-repo/pulls/comments/29724692"
      },
      "html": {
        "href": "https://github.com/baxterthehacker/public-repo/pull/1#discussion_r29724692"
      },
      "pull_request": {
        "href": "https://api.github.com/repos/baxterthehacker/public-repo/pulls/1"
      }
    }
  },
  "pull_request": {
    "url": "https://api.github.com/repos/baxterthehacker/public-repo/pulls/1",
    "id": 34778301,
    "html_url": "https://github.com/baxterthehacker/public-repo/pull/1",
    "diff_url": "https://github.com/baxterthehacker/public-repo/pull/1.diff",
    "patch_url": "https://github.com/baxterthehacker/public-repo/pull/1.patch",
    "issue_url": "https://api.github.com/repos/baxterthehacker/public-repo/issues/1",
    "number": 1,
    "state": "open",
    "locked": false,
    "title": "Update the README with new information",
    "user": {
      "login": "baxterthehacker",
      "id": 6752317,
      "avatar_url": "https://avatars.githubusercontent.com/u/6752317?v=3",
      "gravatar_id": "",
      "url": "https://api.github.com/users/baxterthehacker",
      "html_url": "https://github.com/baxterthehacker",
      "followers_url": "https://api.github.com/users/baxterthehacker/followers",
      "following_url": "https://api.github.com/users/baxterthehacker/following{/other_user}",
      "gists_url": "https://api.github.com/users/baxterthehacker/gists{/gist_id}",
      "starred_url": "https://api.github.com/users/baxterthehacker/starred{/owner}{/repo}",
      "subscriptions_url": "https://api.github.com/users/baxterthehacker/subscriptions",
      "organizations_url": "https://api.github.com/users/baxterthehacker/orgs",
      "repos_url": "https://api.github.com/users/baxterthehacker/repos",
      "events_url": "https://api.github.com/users/baxterthehacker/events{/privacy}",
      "received_events_url": "https://api.github.com/users/baxterthehacker/received_events",
      "type": "User",
      "site_admin": false
    },
    "body": "This is a pretty simple change that we need to pull into master.",
    "created_at": "2015-05-05T23:40:27Z",
    "updated_at": "2015-05-05T23:40:27Z",
    "closed_at": null,
    "merged_at": null,
    "merge_commit_sha": "18721552ba489fb84e12958c1b5694b5475f7991",
    "assignee": null,
    "milestone": null,
    "commits_url": "https://api.github.com/repos/baxterthehacker/public-repo/pulls/1/commits",
    "review_comments_url": "https://api.github.com/repos/baxterthehacker/public-repo/pulls/1/comments",
    "review_comment_url": "https://api.github.com/repos/baxterthehacker/public-repo/pulls/comments{/number}",
    "comments_url": "https://api.github.com/repos/baxterthehacker/public-repo/issues/1/comments",
    "statuses_url": "https://api.github.com/repos/baxterthehacker/public-repo/statuses/0d1a26e67d8f5eaf1f6ba5c57fc3c7d91ac0fd1c",
    "head": {
      "label": "baxterthehacker:changes",
      "ref": "changes",
      "sha": "0d1a26e67d8f5eaf1f6ba5c57fc3c7d91ac0fd1c",
      "user": {
        "login": "baxterthehacker",
        "id": 6752317,
        "avatar_url": "https://avatars.githubusercontent.com/u/6752317?v=3",
        "gravatar_id": "",
        "url": "https://api.github.com/users/baxterthehacker",
        "html_url": "https://github.com/baxterthehacker",
        "followers_url": "https://api.github.com/users/baxterthehacker/followers",
        "following_url": "https://api.github.com/users/baxterthehacker/following{/other_user}",
        "gists_url": "https://api.github.com/users/baxterthehacker/gists{/gist_id}",
        "starred_url": "https://api.github.com/users/baxterthehacker/starred{/owner}{/repo}",
        "subscriptions_url": "https://api.github.com/users/baxterthehacker/subscriptions",
        "organizations_url": "https://api.github.com/users/baxterthehacker/orgs",
        "repos_url": "https://api.github.com/users/baxterthehacker/repos",
        "events_url": "https://api.github.com/users/baxterthehacker/events{/privacy}",
        "received_events_url": "https://api.github.com/users/baxterthehacker/received_events",
        "type": "User",
        "site_admin": false
      },
      "repo": {
        "id": 35129377,
        "name": "public-repo",
        "full_name": "baxterthehacker/public-repo",
        "owner": {
          "login": "baxterthehacker",
          "id": 6752317,
          "avatar_url": "https://avatars.githubusercontent.com/u/6752317?v=3",
          "gravatar_id": "",
          "url": "https://api.github.com/users/baxterthehacker",
          "html_url": "https://github.com/baxterthehacker",
          "followers_url": "https://api.github.com/users/baxterthehacker/followers",
          "following_url": "https://api.github.com/users/baxterthehacker/following{/other_user}",
          "gists_url": "https://api.github.com/users/baxterthehacker/gists{/gist_id}",
          "starred_url": "https://api.github.com/users/baxterthehacker/starred{/owner}{/repo}",
          "subscriptions_url": "https://api.github.com/users/baxterthehacker/subscriptions",
          "organizations_url": "https://api.github.com/users/baxterthehacker/orgs",
          "repos_url": "https://api.github.com/users/baxterthehacker/repos",
          "events_url": "https://api.github.com/users/baxterthehacker/events{/privacy}",
          "received_events_url": "https://api.github.com/users/baxterthehacker/received_events",
          "type": "User",
          "site_admin": false
        },
        "private": false,
        "html_url": "https://github.com/baxterthehacker/public-repo",
        "description": "",
        "fork": false,
        "url": "https://api.github.com/repos/baxterthehacker/public-repo",
        "forks_url": "https://api.github.com/repos/baxterthehacker/public-repo/forks",
        "keys_url": "https://api.github.com/repos/baxterthehacker/public-repo/keys{/key_id}",
        "collaborators_url": "https://api.github.com/repos/baxterthehacker/public-repo/collaborators{/collaborator}",
        "teams_url": "https://api.github.com/repos/baxterthehacker/public-repo/teams",
        "hooks_url": "https://api.github.com/repos/baxterthehacker/public-repo/hooks",
        "issue_events_url": "https://api.github.com/repos/baxterthehacker/public-repo/issues/events{/number}",
        "events_url": "https://api.github.com/repos/baxterthehacker/public-repo/events",
        "assignees_url": "https://api.github.com/repos/baxterthehacker/public-repo/assignees{/user}",
        "branches_url": "https://api.github.com/repos/baxterthehacker/public-repo/branches{/branch}",
        "tags_url": "https://api.github.com/repos/baxterthehacker/public-repo/tags",
        "blobs_url": "https://api.github.com/repos/baxterthehacker/public-repo/git/blobs{/sha}",
        "git_tags_url": "https://api.github.com/repos/baxterthehacker/public-repo/git/tags{/sha}",
        "git_refs_url": "https://api.github.com/repos/baxterthehacker/public-repo/git/refs{/sha}",
        "trees_url": "https://api.github.com/repos/baxterthehacker/public-repo/git/trees{/sha}",
        "statuses_url": "https://api.github.com/repos/baxterthehacker/public-repo/statuses/{sha}",
        "languages_url": "https://api.github.com/repos/baxterthehacker/public-repo/languages",
        "stargazers_url": "https://api.github.com/repos/baxterthehacker/public-repo/stargazers",
        "contributors_url": "https://api.github.com/repos/baxterthehacker/public-repo/contributors",
        "subscribers_url": "https://api.github.com/repos/baxterthehacker/public-repo/subscribers",
        "subscription_url": "https://api.github.com/repos/baxterthehacker/public-repo/subscription",
        "commits_url": "https://api.github.com/repos/baxterthehacker/public-repo/commits{/sha}",
        "git_commits_url": "https://api.github.com/repos/baxterthehacker/public-repo/git/commits{/sha}",
        "comments_url": "https://api.github.com/repos/baxterthehacker/public-repo/comments{/number}",
        "issue_comment_url": "https://api.github.com/repos/baxterthehacker/public-repo/issues/comments{/number}",
        "contents_url": "https://api.github.com/repos/baxterthehacker/public-repo/contents/{+path}",
        "compare_url": "https://api.github.com/repos/baxterthehacker/public-repo/compare/{base}...{head}",
        "merges_url": "https://api.github.com/repos/baxterthehacker/public-repo/merges",
        "archive_url": "https://api.github.com/repos/baxterthehacker/public-repo/{archive_format}{/ref}",
        "downloads_url": "https://api.github.com/repos/baxterthehacker/public-repo/downloads",
        "issues_url": "https://api.github.com/repos/baxterthehacker/public-repo/issues{/number}",
        "pulls_url": "https://api.github.com/repos/baxterthehacker/public-repo/pulls{/number}",
        "milestones_url": "https://api.github.com/repos/baxterthehacker/public-repo/milestones{/number}",
        "notifications_url": "https://api.github.com/repos/baxterthehacker/public-repo/notifications{?since,all,participating}",
        "labels_url": "https://api.github.com/repos/baxterthehacker/public-repo/labels{/name}",
        "releases_url": "https://api.github.com/repos/baxterthehacker/public-repo/releases{/id}",
        "created_at": "2015-05-05T23:40:12Z",
        "updated_at": "2015-05-05T23:40:12Z",
        "pushed_at": "2015-05-05T23:40:27Z",
        "git_url": "git://github.com/baxterthehacker/public-repo.git",
        "ssh_url": "git@github.com:baxterthehacker/public-repo.git",
        "clone_url": "https://github.com/baxterthehacker/public-repo.git",
        "svn_url": "https://github.com/baxterthehacker/public-repo",
        "homepage": null,
        "size": 0,
        "stargazers_count": 0,
        "watchers_count": 0,
        "language": null,
        "has_issues": true,
        "has_downloads": true,
        "has_wiki": true,
        "has_pages": true,
        "forks_count": 0,
        "mirror_url": null,
        "open_issues_count": 1,
        "forks": 0,
        "open_issues": 1,
        "watchers": 0,
        "default_branch": "master"
      }
    },
    "base": {
      "label": "baxterthehacker:master",
      "ref": "master",
      "sha": "9049f1265b7d61be4a8904a9a27120d2064dab3b",
      "user": {
        "login": "baxterthehacker",
        "id": 6752317,
        "avatar_url": "https://avatars.githubusercontent.com/u/6752317?v=3",
        "gravatar_id": "",
        "url": "https://api.github.com/users/baxterthehacker",
        "html_url": "https://github.com/baxterthehacker",
        "followers_url": "https://api.github.com/users/baxterthehacker/followers",
        "following_url": "https://api.github.com/users/baxterthehacker/following{/other_user}",
        "gists_url": "https://api.github.com/users/baxterthehacker/gists{/gist_id}",
        "starred_url": "https://api.github.com/users/baxterthehacker/starred{/owner}{/repo}",
        "subscriptions_url": "https://api.github.com/users/baxterthehacker/subscriptions",
        "organizations_url": "https://api.github.com/users/baxterthehacker/orgs",
        "repos_url": "https://api.github.com/users/baxterthehacker/repos",
        "events_url": "https://api.github.com/users/baxterthehacker/events{/privacy}",
        "received_events_url": "https://api.github.com/users/baxterthehacker/received_events",
        "type": "User",
        "site_admin": false
      },
      "repo": {
        "id": 35129377,
        "name": "public-repo",
        "full_name": "baxterthehacker/public-repo",
        "owner": {
          "login": "baxterthehacker",
          "id": 6752317,
          "avatar_url": "https://avatars.githubusercontent.com/u/6752317?v=3",
          "gravatar_id": "",
          "url": "https://api.github.com/users/baxterthehacker",
          "html_url": "https://github.com/baxterthehacker",
          "followers_url": "https://api.github.com/users/baxterthehacker/followers",
          "following_url": "https://api.github.com/users/baxterthehacker/following{/other_user}",
          "gists_url": "https://api.github.com/users/baxterthehacker/gists{/gist_id}",
          "starred_url": "https://api.github.com/users/baxterthehacker/starred{/owner}{/repo}",
          "subscriptions_url": "https://api.github.com/users/baxterthehacker/subscriptions",
          "organizations_url": "https://api.github.com/users/baxterthehacker/orgs",
          "repos_url": "https://api.github.com/users/baxterthehacker/repos",
          "events_url": "https://api.github.com/users/baxterthehacker/events{/privacy}",
          "received_events_url": "https://api.github.com/users/baxterthehacker/received_events",
          "type": "User",
          "site_admin": false
        },
        "private": false,
        "html_url": "https://github.com/baxterthehacker/public-repo",
        "description": "",
        "fork": false,
        "url": "https://api.github.com/repos/baxterthehacker/public-repo",
        "forks_url": "https://api.github.com/repos/baxterthehacker/public-repo/forks",
        "keys_url": "https://api.github.com/repos/baxterthehacker/public-repo/keys{/key_id}",
        "collaborators_url": "https://api.github.com/repos/baxterthehacker/public-repo/collaborators{/collaborator}",
        "teams_url": "https://api.github.com/repos/baxterthehacker/public-repo/teams",
        "hooks_url": "https://api.github.com/repos/baxterthehacker/public-repo/hooks",
        "issue_events_url": "https://api.github.com/repos/baxterthehacker/public-repo/issues/events{/number}",
        "events_url": "https://api.github.com/repos/baxterthehacker/public-repo/events",
        "assignees_url": "https://api.github.com/repos/baxterthehacker/public-repo/assignees{/user}",
        "branches_url": "https://api.github.com/repos/baxterthehacker/public-repo/branches{/branch}",
        "tags_url": "https://api.github.com/repos/baxterthehacker/public-repo/tags",
        "blobs_url": "https://api.github.com/repos/baxterthehacker/public-repo/git/blobs{/sha}",
        "git_tags_url": "https://api.github.com/repos/baxterthehacker/public-repo/git/tags{/sha}",
        "git_refs_url": "https://api.github.com/repos/baxterthehacker/public-repo/git/refs{/sha}",
        "trees_url": "https://api.github.com/repos/baxterthehacker/public-repo/git/trees{/sha}",
        "statuses_url": "https://api.github.com/repos/baxterthehacker/public-repo/statuses/{sha}",
        "languages_url": "https://api.github.com/repos/baxterthehacker/public-repo/languages",
        "stargazers_url": "https://api.github.com/repos/baxterthehacker/public-repo/stargazers",
        "contributors_url": "https://api.github.com/repos/baxterthehacker/public-repo/contributors",
        "subscribers_url": "https://api.github.com/repos/baxterthehacker/public-repo/subscribers",
        "subscription_url": "https://api.github.com/repos/baxterthehacker/public-repo/subscription",
        "commits_url": "https://api.github.com/repos/baxterthehacker/public-repo/commits{/sha}",
        "git_commits_url": "https://api.github.com/repos/baxterthehacker/public-repo/git/commits{/sha}",
        "comments_url": "https://api.github.com/repos/baxterthehacker/public-repo/comments{/number}",
        "issue_comment_url": "https://api.github.com/repos/baxterthehacker/public-repo/issues/comments{/number}",
        "contents_url": "https://api.github.com/repos/baxterthehacker/public-repo/contents/{+path}",
        "compare_url": "https://api.github.com/repos/baxterthehacker/public-repo/compare/{base}...{head}",
        "merges_url": "https://api.github.com/repos/baxterthehacker/public-repo/merges",
        "archive_url": "https://api.github.com/repos/baxterthehacker/public-repo/{archive_format}{/ref}",
        "downloads_url": "https://api.github.com/repos/baxterthehacker/public-repo/downloads",
        "issues_url": "https://api.github.com/repos/baxterthehacker/public-repo/issues{/number}",
        "pulls_url": "https://api.github.com/repos/baxterthehacker/public-repo/pulls{/number}",
        "milestones_url": "https://api.github.com/repos/baxterthehacker/public-repo/milestones{/number}",
        "notifications_url": "https://api.github.com/repos/baxterthehacker/public-repo/notifications{?since,all,participating}",
        "labels_url": "https://api.github.com/repos/baxterthehacker/public-repo/labels{/name}",
        "releases_url": "https://api.github.com/repos/baxterthehacker/public-repo/releases{/id}",
        "created_at": "2015-05-05T23:40:12Z",
        "updated_at": "2015-05-05T23:40:12Z",
        "pushed_at": "2015-05-05T23:40:27Z",
        "git_url": "git://github.com/baxterthehacker/public-repo.git",
        "ssh_url": "git@github.com:baxterthehacker/public-repo.git",
        "clone_url": "https://github.com/baxterthehacker/public-repo.git",
        "svn_url": "https://github.com/baxterthehacker/public-repo",
        "homepage": null,
        "size": 0,
        "stargazers_count": 0,
        "watchers_count": 0,
        "language": null,
        "has_issues": true,
        "has_downloads": true,
        "has_wiki": true,
        "has_pages": true,
        "forks_count": 0,
        "mirror_url": null,
        "open_issues_count": 1,
        "forks": 0,
        "open_issues": 1,
        "watchers": 0,
        "default_branch": "master"
      }
    },
    "_links": {
      "self": {
        "href": "https://api.github.com/repos/baxterthehacker/public-repo/pulls/1"
      },
      "html": {
        "href": "https://github.com/baxterthehacker/public-repo/pull/1"
      },
      "issue": {
        "href": "https://api.github.com/repos/baxterthehacker/public-repo/issues/1"
      },
      "comments": {
        "href": "https://api.github.com/repos/baxterthehacker/public-repo/issues/1/comments"
      },
      "review_comments": {
        "href": "https://api.github.com/repos/baxterthehacker/public-repo/pulls/1/comments"
      },
      "review_comment": {
        "href": "https://api.github.com/repos/baxterthehacker/public-repo/pulls/comments{/number}"
      },
      "commits": {
        "href": "https://api.github.com/repos/baxterthehacker/public-repo/pulls/1/commits"
      },
      "statuses": {
        "href": "https://api.github.com/repos/baxterthehacker/public-repo/statuses/0d1a26e67d8f5eaf1f6ba5c57fc3c7d91ac0fd1c"
      }
    }
  },
  "repository": {
    "id": 35129377,
    "name": "public-repo",
    "full_name": "baxterthehacker/public-repo",
    "owner": {
      "login": "baxterthehacker",
      "id": 6752317,
      "avatar_url": "https://avatars.githubusercontent.com/u/6752317?v=3",
      "gravatar_id": "",
      "url": "https://api.github.com/users/baxterthehacker",
      "html_url": "https://github.com/baxterthehacker",
      "followers_url": "https://api.github.com/users/baxterthehacker/followers",
      "following_url": "https://api.github.com/users/baxterthehacker/following{/other_user}",
      "gists_url": "https://api.github.com/users/baxterthehacker/gists{/gist_id}",
      "starred_url": "https://api.github.com/users/baxterthehacker/starred{/owner}{/repo}",
      "subscriptions_url": "https://api.github.com/users/baxterthehacker/subscriptions",
      "organizations_url": "https://api.github.com/users/baxterthehacker/orgs",
      "repos_url": "https://api.github.com/users/baxterthehacker/repos",
      "events_url": "https://api.github.com/users/baxterthehacker/events{/privacy}",
      "received_events_url": "https://api.github.com/users/baxterthehacker/received_events",
      "type": "User",
      "site_admin": false
    },
    "private": false,
    "html_url": "https://github.com/baxterthehacker/public-repo",
    "description": "",
    "fork": false,
    "url": "https://api.github.com/repos/baxterthehacker/public-repo",
    "forks_url": "https://api.github.com/repos/baxterthehacker/public-repo/forks",
    "keys_url": "https://api.github.com/repos/baxterthehacker/public-repo/keys{/key_id}",
    "collaborators_url": "https://api.github.com/repos/baxterthehacker/public-repo/collaborators{/collaborator}",
    "teams_url": "https://api.github.com/repos/baxterthehacker/public-repo/teams",
    "hooks_url": "https://api.github.com/repos/baxterthehacker/public-repo/hooks",
    "issue_events_url": "https://api.github.com/repos/baxterthehacker/public-repo/issues/events{/number}",
    "events_url": "https://api.github.com/repos/baxterthehacker/public-repo/events",
    "assignees_url": "https://api.github.com/repos/baxterthehacker/public-repo/assignees{/user}",
    "branches_url": "https://api.github.com/repos/baxterthehacker/public-repo/branches{/branch}",
    "tags_url": "https://api.github.com/repos/baxterthehacker/public-repo/tags",
    "blobs_url": "https://api.github.com/repos/baxterthehacker/public-repo/git/blobs{/sha}",
    "git_tags_url": "https://api.github.com/repos/baxterthehacker/public-repo/git/tags{/sha}",
    "git_refs_url": "https://api.github.com/repos/baxterthehacker/public-repo/git/refs{/sha}",
    "trees_url": "https://api.github.com/repos/baxterthehacker/public-repo/git/trees{/sha}",
    "statuses_url": "https://api.github.com/repos/baxterthehacker/public-repo/statuses/{sha}",
    "languages_url": "https://api.github.com/repos/baxterthehacker/public-repo/languages",
    "stargazers_url": "https://api.github.com/repos/baxterthehacker/public-repo/stargazers",
    "contributors_url": "https://api.github.com/repos/baxterthehacker/public-repo/contributors",
    "subscribers_url": "https://api.github.com/repos/baxterthehacker/public-repo/subscribers",
    "subscription_url": "https://api.github.com/repos/baxterthehacker/public-repo/subscription",
    "commits_url": "https://api.github.com/repos/baxterthehacker/public-repo/commits{/sha}",
    "git_commits_url": "https://api.github.com/repos/baxterthehacker/public-repo/git/commits{/sha}",
    "comments_url": "https://api.github.com/repos/baxterthehacker/public-repo/comments{/number}",
    "issue_comment_url": "https://api.github.com/repos/baxterthehacker/public-repo/issues/comments{/number}",
    "contents_url": "https://api.github.com/repos/baxterthehacker/public-repo/contents/{+path}",
    "compare_url": "https://api.github.com/repos/baxterthehacker/public-repo/compare/{base}...{head}",
    "merges_url": "https://api.github.com/repos/baxterthehacker/public-repo/merges",
    "archive_url": "https://api.github.com/repos/baxterthehacker/public-repo/{archive_format}{/ref}",
    "downloads_url": "https://api.github.com/repos/baxterthehacker/public-repo/downloads",
    "issues_url": "https://api.github.com/repos/baxterthehacker/public-repo/issues{/number}",
    "pulls_url": "https://api.github.com/repos/baxterthehacker/public-repo/pulls{/number}",
    "milestones_url": "https://api.github.com/repos/baxterthehacker/public-repo/milestones{/number}",
    "notifications_url": "https://api.github.com/repos/baxterthehacker/public-repo/notifications{?since,all,participating}",
    "labels_url": "https://api.github.com/repos/baxterthehacker/public-repo/labels{/name}",
    "releases_url": "https://api.github.com/repos/baxterthehacker/public-repo/releases{/id}",
    "created_at": "2015-05-05T23:40:12Z",
    "updated_at": "2015-05-05T23:40:12Z",
    "pushed_at": "2015-05-05T23:40:27Z",
    "git_url": "git://github.com/baxterthehacker/public-repo.git",
    "ssh_url": "git@github.com:baxterthehacker/public-repo.git",
    "clone_url": "https://github.com/baxterthehacker/public-repo.git",
    "svn_url": "https://github.com/baxterthehacker/public-repo",
    "homepage": null,
    "size": 0,
    "stargazers_count": 0,
    "watchers_count": 0,
    "language": null,
    "has_issues": true,
    "has_downloads": true,
    "has_wiki": true,
    "has_pages": true,
    "forks_count": 0,
    "mirror_url": null,
    "open_issues_count": 1,
    "forks": 0,
    "open_issues": 1,
    "watchers": 0,
    "default_branch": "master"
  },
  "sender": {
    "login": "baxterthehacker",
    "id": 6752317,
    "avatar_url": "https://avatars.githubusercontent.com/u/6752317?v=3",
    "gravatar_id": "",
    "url": "https://api.github.com/users/baxterthehacker",
    "html_url": "https://github.com/baxterthehacker",
    "followers_url": "https://api.github.com/users/baxterthehacker/followers",
    "following_url": "https://api.github.com/users/baxterthehacker/following{/other_user}",
    "gists_url": "https://api.github.com/users/baxterthehacker/gists{/gist_id}",
    "starred_url": "https://api.github.com/users/baxterthehacker/starred{/owner}{/repo}",
    "subscriptions_url": "https://api.github.com/users/baxterthehacker/subscriptions",
    "organizations_url": "https://api.github.com/users/baxterthehacker/orgs",
    "repos_url": "https://api.github.com/users/baxterthehacker/repos",
    "events_url": "https://api.github.com/users/baxterthehacker/events{/privacy}",
    "received_events_url": "https://api.github.com/users/baxterthehacker/received_events",
    "type": "User",
    "site_admin": false
  }
}

PushEvent

Triggered on a push to a repository branch. Branch pushes and repository tag pushes also trigger webhook push events.

Note: The webhook payload example following the table differs significantly from the Events API payload described in the table. Among other differences, the webhook payload includes both sender and pusher objects. Sender and pusher are the same user who initiated the push event, but the sender object contains more detail.

Events API payload

Key Type Description
ref string The full Git ref that was pushed. Example: refs/heads/master.
head string The SHA of the most recent commit on ref after the push.
before string The SHA of the most recent commit on ref before the push.
size integer The number of commits in the push.
distinct_size integer The number of distinct commits in the push.
commits array An array of commit objects describing the pushed commits. (The array includes a maximum of 20 commits. If necessary, you can use the Commits API to fetch additional commits. This limit is applied to timeline events only and isn't applied to webhook deliveries.)
commits[][sha] string The SHA of the commit.
commits[][message] string The commit message.
commits[][author] object The git author of the commit.
commits[][author][name] string The git author's name.
commits[][author][email] string The git author's email address.
commits[][url] url URL that points to the commit API resource.
commits[][distinct] boolean Whether this commit is distinct from any that have been pushed before.

Webhook event name

push

Webhook payload example

{
  "ref": "refs/heads/changes",
  "before": "9049f1265b7d61be4a8904a9a27120d2064dab3b",
  "after": "0d1a26e67d8f5eaf1f6ba5c57fc3c7d91ac0fd1c",
  "created": false,
  "deleted": false,
  "forced": false,
  "base_ref": null,
  "compare": "https://github.com/baxterthehacker/public-repo/compare/9049f1265b7d...0d1a26e67d8f",
  "commits": [
    {
      "id": "0d1a26e67d8f5eaf1f6ba5c57fc3c7d91ac0fd1c",
      "tree_id": "f9d2a07e9488b91af2641b26b9407fe22a451433",
      "distinct": true,
      "message": "Update README.md",
      "timestamp": "2015-05-05T19:40:15-04:00",
      "url": "https://github.com/baxterthehacker/public-repo/commit/0d1a26e67d8f5eaf1f6ba5c57fc3c7d91ac0fd1c",
      "author": {
        "name": "baxterthehacker",
        "email": "baxterthehacker@users.noreply.github.com",
        "username": "baxterthehacker"
      },
      "committer": {
        "name": "baxterthehacker",
        "email": "baxterthehacker@users.noreply.github.com",
        "username": "baxterthehacker"
      },
      "added": [

      ],
      "removed": [

      ],
      "modified": [
        "README.md"
      ]
    }
  ],
  "head_commit": {
    "id": "0d1a26e67d8f5eaf1f6ba5c57fc3c7d91ac0fd1c",
    "tree_id": "f9d2a07e9488b91af2641b26b9407fe22a451433",
    "distinct": true,
    "message": "Update README.md",
    "timestamp": "2015-05-05T19:40:15-04:00",
    "url": "https://github.com/baxterthehacker/public-repo/commit/0d1a26e67d8f5eaf1f6ba5c57fc3c7d91ac0fd1c",
    "author": {
      "name": "baxterthehacker",
      "email": "baxterthehacker@users.noreply.github.com",
      "username": "baxterthehacker"
    },
    "committer": {
      "name": "baxterthehacker",
      "email": "baxterthehacker@users.noreply.github.com",
      "username": "baxterthehacker"
    },
    "added": [

    ],
    "removed": [

    ],
    "modified": [
      "README.md"
    ]
  },
  "repository": {
    "id": 35129377,
    "name": "public-repo",
    "full_name": "baxterthehacker/public-repo",
    "owner": {
      "name": "baxterthehacker",
      "email": "baxterthehacker@users.noreply.github.com"
    },
    "private": false,
    "html_url": "https://github.com/baxterthehacker/public-repo",
    "description": "",
    "fork": false,
    "url": "https://github.com/baxterthehacker/public-repo",
    "forks_url": "https://api.github.com/repos/baxterthehacker/public-repo/forks",
    "keys_url": "https://api.github.com/repos/baxterthehacker/public-repo/keys{/key_id}",
    "collaborators_url": "https://api.github.com/repos/baxterthehacker/public-repo/collaborators{/collaborator}",
    "teams_url": "https://api.github.com/repos/baxterthehacker/public-repo/teams",
    "hooks_url": "https://api.github.com/repos/baxterthehacker/public-repo/hooks",
    "issue_events_url": "https://api.github.com/repos/baxterthehacker/public-repo/issues/events{/number}",
    "events_url": "https://api.github.com/repos/baxterthehacker/public-repo/events",
    "assignees_url": "https://api.github.com/repos/baxterthehacker/public-repo/assignees{/user}",
    "branches_url": "https://api.github.com/repos/baxterthehacker/public-repo/branches{/branch}",
    "tags_url": "https://api.github.com/repos/baxterthehacker/public-repo/tags",
    "blobs_url": "https://api.github.com/repos/baxterthehacker/public-repo/git/blobs{/sha}",
    "git_tags_url": "https://api.github.com/repos/baxterthehacker/public-repo/git/tags{/sha}",
    "git_refs_url": "https://api.github.com/repos/baxterthehacker/public-repo/git/refs{/sha}",
    "trees_url": "https://api.github.com/repos/baxterthehacker/public-repo/git/trees{/sha}",
    "statuses_url": "https://api.github.com/repos/baxterthehacker/public-repo/statuses/{sha}",
    "languages_url": "https://api.github.com/repos/baxterthehacker/public-repo/languages",
    "stargazers_url": "https://api.github.com/repos/baxterthehacker/public-repo/stargazers",
    "contributors_url": "https://api.github.com/repos/baxterthehacker/public-repo/contributors",
    "subscribers_url": "https://api.github.com/repos/baxterthehacker/public-repo/subscribers",
    "subscription_url": "https://api.github.com/repos/baxterthehacker/public-repo/subscription",
    "commits_url": "https://api.github.com/repos/baxterthehacker/public-repo/commits{/sha}",
    "git_commits_url": "https://api.github.com/repos/baxterthehacker/public-repo/git/commits{/sha}",
    "comments_url": "https://api.github.com/repos/baxterthehacker/public-repo/comments{/number}",
    "issue_comment_url": "https://api.github.com/repos/baxterthehacker/public-repo/issues/comments{/number}",
    "contents_url": "https://api.github.com/repos/baxterthehacker/public-repo/contents/{+path}",
    "compare_url": "https://api.github.com/repos/baxterthehacker/public-repo/compare/{base}...{head}",
    "merges_url": "https://api.github.com/repos/baxterthehacker/public-repo/merges",
    "archive_url": "https://api.github.com/repos/baxterthehacker/public-repo/{archive_format}{/ref}",
    "downloads_url": "https://api.github.com/repos/baxterthehacker/public-repo/downloads",
    "issues_url": "https://api.github.com/repos/baxterthehacker/public-repo/issues{/number}",
    "pulls_url": "https://api.github.com/repos/baxterthehacker/public-repo/pulls{/number}",
    "milestones_url": "https://api.github.com/repos/baxterthehacker/public-repo/milestones{/number}",
    "notifications_url": "https://api.github.com/repos/baxterthehacker/public-repo/notifications{?since,all,participating}",
    "labels_url": "https://api.github.com/repos/baxterthehacker/public-repo/labels{/name}",
    "releases_url": "https://api.github.com/repos/baxterthehacker/public-repo/releases{/id}",
    "created_at": 1430869212,
    "updated_at": "2015-05-05T23:40:12Z",
    "pushed_at": 1430869217,
    "git_url": "git://github.com/baxterthehacker/public-repo.git",
    "ssh_url": "git@github.com:baxterthehacker/public-repo.git",
    "clone_url": "https://github.com/baxterthehacker/public-repo.git",
    "svn_url": "https://github.com/baxterthehacker/public-repo",
    "homepage": null,
    "size": 0,
    "stargazers_count": 0,
    "watchers_count": 0,
    "language": null,
    "has_issues": true,
    "has_downloads": true,
    "has_wiki": true,
    "has_pages": true,
    "forks_count": 0,
    "mirror_url": null,
    "open_issues_count": 0,
    "forks": 0,
    "open_issues": 0,
    "watchers": 0,
    "default_branch": "master",
    "stargazers": 0,
    "master_branch": "master"
  },
  "pusher": {
    "name": "baxterthehacker",
    "email": "baxterthehacker@users.noreply.github.com"
  },
  "sender": {
    "login": "baxterthehacker",
    "id": 6752317,
    "avatar_url": "https://avatars.githubusercontent.com/u/6752317?v=3",
    "gravatar_id": "",
    "url": "https://api.github.com/users/baxterthehacker",
    "html_url": "https://github.com/baxterthehacker",
    "followers_url": "https://api.github.com/users/baxterthehacker/followers",
    "following_url": "https://api.github.com/users/baxterthehacker/following{/other_user}",
    "gists_url": "https://api.github.com/users/baxterthehacker/gists{/gist_id}",
    "starred_url": "https://api.github.com/users/baxterthehacker/starred{/owner}{/repo}",
    "subscriptions_url": "https://api.github.com/users/baxterthehacker/subscriptions",
    "organizations_url": "https://api.github.com/users/baxterthehacker/orgs",
    "repos_url": "https://api.github.com/users/baxterthehacker/repos",
    "events_url": "https://api.github.com/users/baxterthehacker/events{/privacy}",
    "received_events_url": "https://api.github.com/users/baxterthehacker/received_events",
    "type": "User",
    "site_admin": false
  }
}

ReleaseEvent

Triggered when a release is published.

Events API payload

Key Type Description
action string The action that was performed. Currently, can only be "published".
release object The release itself.

Webhook event name

release

Webhook payload example

{
  "action": "published",
  "release": {
    "url": "https://api.github.com/repos/baxterthehacker/public-repo/releases/1261438",
    "assets_url": "https://api.github.com/repos/baxterthehacker/public-repo/releases/1261438/assets",
    "upload_url": "https://uploads.github.com/repos/baxterthehacker/public-repo/releases/1261438/assets{?name}",
    "html_url": "https://github.com/baxterthehacker/public-repo/releases/tag/0.0.1",
    "id": 1261438,
    "tag_name": "0.0.1",
    "target_commitish": "master",
    "name": null,
    "draft": false,
    "author": {
      "login": "baxterthehacker",
      "id": 6752317,
      "avatar_url": "https://avatars.githubusercontent.com/u/6752317?v=3",
      "gravatar_id": "",
      "url": "https://api.github.com/users/baxterthehacker",
      "html_url": "https://github.com/baxterthehacker",
      "followers_url": "https://api.github.com/users/baxterthehacker/followers",
      "following_url": "https://api.github.com/users/baxterthehacker/following{/other_user}",
      "gists_url": "https://api.github.com/users/baxterthehacker/gists{/gist_id}",
      "starred_url": "https://api.github.com/users/baxterthehacker/starred{/owner}{/repo}",
      "subscriptions_url": "https://api.github.com/users/baxterthehacker/subscriptions",
      "organizations_url": "https://api.github.com/users/baxterthehacker/orgs",
      "repos_url": "https://api.github.com/users/baxterthehacker/repos",
      "events_url": "https://api.github.com/users/baxterthehacker/events{/privacy}",
      "received_events_url": "https://api.github.com/users/baxterthehacker/received_events",
      "type": "User",
      "site_admin": false
    },
    "prerelease": false,
    "created_at": "2015-05-05T23:40:12Z",
    "published_at": "2015-05-05T23:40:38Z",
    "assets": [

    ],
    "tarball_url": "https://api.github.com/repos/baxterthehacker/public-repo/tarball/0.0.1",
    "zipball_url": "https://api.github.com/repos/baxterthehacker/public-repo/zipball/0.0.1",
    "body": null
  },
  "repository": {
    "id": 35129377,
    "name": "public-repo",
    "full_name": "baxterthehacker/public-repo",
    "owner": {
      "login": "baxterthehacker",
      "id": 6752317,
      "avatar_url": "https://avatars.githubusercontent.com/u/6752317?v=3",
      "gravatar_id": "",
      "url": "https://api.github.com/users/baxterthehacker",
      "html_url": "https://github.com/baxterthehacker",
      "followers_url": "https://api.github.com/users/baxterthehacker/followers",
      "following_url": "https://api.github.com/users/baxterthehacker/following{/other_user}",
      "gists_url": "https://api.github.com/users/baxterthehacker/gists{/gist_id}",
      "starred_url": "https://api.github.com/users/baxterthehacker/starred{/owner}{/repo}",
      "subscriptions_url": "https://api.github.com/users/baxterthehacker/subscriptions",
      "organizations_url": "https://api.github.com/users/baxterthehacker/orgs",
      "repos_url": "https://api.github.com/users/baxterthehacker/repos",
      "events_url": "https://api.github.com/users/baxterthehacker/events{/privacy}",
      "received_events_url": "https://api.github.com/users/baxterthehacker/received_events",
      "type": "User",
      "site_admin": false
    },
    "private": false,
    "html_url": "https://github.com/baxterthehacker/public-repo",
    "description": "",
    "fork": false,
    "url": "https://api.github.com/repos/baxterthehacker/public-repo",
    "forks_url": "https://api.github.com/repos/baxterthehacker/public-repo/forks",
    "keys_url": "https://api.github.com/repos/baxterthehacker/public-repo/keys{/key_id}",
    "collaborators_url": "https://api.github.com/repos/baxterthehacker/public-repo/collaborators{/collaborator}",
    "teams_url": "https://api.github.com/repos/baxterthehacker/public-repo/teams",
    "hooks_url": "https://api.github.com/repos/baxterthehacker/public-repo/hooks",
    "issue_events_url": "https://api.github.com/repos/baxterthehacker/public-repo/issues/events{/number}",
    "events_url": "https://api.github.com/repos/baxterthehacker/public-repo/events",
    "assignees_url": "https://api.github.com/repos/baxterthehacker/public-repo/assignees{/user}",
    "branches_url": "https://api.github.com/repos/baxterthehacker/public-repo/branches{/branch}",
    "tags_url": "https://api.github.com/repos/baxterthehacker/public-repo/tags",
    "blobs_url": "https://api.github.com/repos/baxterthehacker/public-repo/git/blobs{/sha}",
    "git_tags_url": "https://api.github.com/repos/baxterthehacker/public-repo/git/tags{/sha}",
    "git_refs_url": "https://api.github.com/repos/baxterthehacker/public-repo/git/refs{/sha}",
    "trees_url": "https://api.github.com/repos/baxterthehacker/public-repo/git/trees{/sha}",
    "statuses_url": "https://api.github.com/repos/baxterthehacker/public-repo/statuses/{sha}",
    "languages_url": "https://api.github.com/repos/baxterthehacker/public-repo/languages",
    "stargazers_url": "https://api.github.com/repos/baxterthehacker/public-repo/stargazers",
    "contributors_url": "https://api.github.com/repos/baxterthehacker/public-repo/contributors",
    "subscribers_url": "https://api.github.com/repos/baxterthehacker/public-repo/subscribers",
    "subscription_url": "https://api.github.com/repos/baxterthehacker/public-repo/subscription",
    "commits_url": "https://api.github.com/repos/baxterthehacker/public-repo/commits{/sha}",
    "git_commits_url": "https://api.github.com/repos/baxterthehacker/public-repo/git/commits{/sha}",
    "comments_url": "https://api.github.com/repos/baxterthehacker/public-repo/comments{/number}",
    "issue_comment_url": "https://api.github.com/repos/baxterthehacker/public-repo/issues/comments{/number}",
    "contents_url": "https://api.github.com/repos/baxterthehacker/public-repo/contents/{+path}",
    "compare_url": "https://api.github.com/repos/baxterthehacker/public-repo/compare/{base}...{head}",
    "merges_url": "https://api.github.com/repos/baxterthehacker/public-repo/merges",
    "archive_url": "https://api.github.com/repos/baxterthehacker/public-repo/{archive_format}{/ref}",
    "downloads_url": "https://api.github.com/repos/baxterthehacker/public-repo/downloads",
    "issues_url": "https://api.github.com/repos/baxterthehacker/public-repo/issues{/number}",
    "pulls_url": "https://api.github.com/repos/baxterthehacker/public-repo/pulls{/number}",
    "milestones_url": "https://api.github.com/repos/baxterthehacker/public-repo/milestones{/number}",
    "notifications_url": "https://api.github.com/repos/baxterthehacker/public-repo/notifications{?since,all,participating}",
    "labels_url": "https://api.github.com/repos/baxterthehacker/public-repo/labels{/name}",
    "releases_url": "https://api.github.com/repos/baxterthehacker/public-repo/releases{/id}",
    "created_at": "2015-05-05T23:40:12Z",
    "updated_at": "2015-05-05T23:40:30Z",
    "pushed_at": "2015-05-05T23:40:38Z",
    "git_url": "git://github.com/baxterthehacker/public-repo.git",
    "ssh_url": "git@github.com:baxterthehacker/public-repo.git",
    "clone_url": "https://github.com/baxterthehacker/public-repo.git",
    "svn_url": "https://github.com/baxterthehacker/public-repo",
    "homepage": null,
    "size": 0,
    "stargazers_count": 0,
    "watchers_count": 0,
    "language": null,
    "has_issues": true,
    "has_downloads": true,
    "has_wiki": true,
    "has_pages": true,
    "forks_count": 0,
    "mirror_url": null,
    "open_issues_count": 2,
    "forks": 0,
    "open_issues": 2,
    "watchers": 0,
    "default_branch": "master"
  },
  "sender": {
    "login": "baxterthehacker",
    "id": 6752317,
    "avatar_url": "https://avatars.githubusercontent.com/u/6752317?v=3",
    "gravatar_id": "",
    "url": "https://api.github.com/users/baxterthehacker",
    "html_url": "https://github.com/baxterthehacker",
    "followers_url": "https://api.github.com/users/baxterthehacker/followers",
    "following_url": "https://api.github.com/users/baxterthehacker/following{/other_user}",
    "gists_url": "https://api.github.com/users/baxterthehacker/gists{/gist_id}",
    "starred_url": "https://api.github.com/users/baxterthehacker/starred{/owner}{/repo}",
    "subscriptions_url": "https://api.github.com/users/baxterthehacker/subscriptions",
    "organizations_url": "https://api.github.com/users/baxterthehacker/orgs",
    "repos_url": "https://api.github.com/users/baxterthehacker/repos",
    "events_url": "https://api.github.com/users/baxterthehacker/events{/privacy}",
    "received_events_url": "https://api.github.com/users/baxterthehacker/received_events",
    "type": "User",
    "site_admin": false
  }
}

RepositoryEvent

Triggered when a repository is created, archived, unarchived, made public, or made private. Organization hooks are also triggered when a repository is deleted.

Events of this type are not visible in timelines. These events are only used to trigger hooks.

Events API payload

Key Type Description
action string The action that was performed. This can be one of created, deleted (organization hooks only), archived, unarchived, publicized, or privatized.
repository object The repository itself.

Webhook event name

repository

Webhook payload example

{
  "action": "created",
  "repository": {
    "id": 27496774,
    "name": "new-repository",
    "full_name": "baxterandthehackers/new-repository",
    "owner": {
      "login": "baxterandthehackers",
      "id": 7649605,
      "avatar_url": "https://avatars.githubusercontent.com/u/7649605?v=3",
      "gravatar_id": "",
      "url": "https://api.github.com/users/baxterandthehackers",
      "html_url": "https://github.com/baxterandthehackers",
      "followers_url": "https://api.github.com/users/baxterandthehackers/followers",
      "following_url": "https://api.github.com/users/baxterandthehackers/following{/other_user}",
      "gists_url": "https://api.github.com/users/baxterandthehackers/gists{/gist_id}",
      "starred_url": "https://api.github.com/users/baxterandthehackers/starred{/owner}{/repo}",
      "subscriptions_url": "https://api.github.com/users/baxterandthehackers/subscriptions",
      "organizations_url": "https://api.github.com/users/baxterandthehackers/orgs",
      "repos_url": "https://api.github.com/users/baxterandthehackers/repos",
      "events_url": "https://api.github.com/users/baxterandthehackers/events{/privacy}",
      "received_events_url": "https://api.github.com/users/baxterandthehackers/received_events",
      "type": "Organization",
      "site_admin": false
    },
    "private": true,
    "html_url": "https://github.com/baxterandthehackers/new-repository",
    "description": "",
    "fork": false,
    "url": "https://api.github.com/repos/baxterandthehackers/new-repository",
    "forks_url": "https://api.github.com/repos/baxterandthehackers/new-repository/forks",
    "keys_url": "https://api.github.com/repos/baxterandthehackers/new-repository/keys{/key_id}",
    "collaborators_url": "https://api.github.com/repos/baxterandthehackers/new-repository/collaborators{/collaborator}",
    "teams_url": "https://api.github.com/repos/baxterandthehackers/new-repository/teams",
    "hooks_url": "https://api.github.com/repos/baxterandthehackers/new-repository/hooks",
    "issue_events_url": "https://api.github.com/repos/baxterandthehackers/new-repository/issues/events{/number}",
    "events_url": "https://api.github.com/repos/baxterandthehackers/new-repository/events",
    "assignees_url": "https://api.github.com/repos/baxterandthehackers/new-repository/assignees{/user}",
    "branches_url": "https://api.github.com/repos/baxterandthehackers/new-repository/branches{/branch}",
    "tags_url": "https://api.github.com/repos/baxterandthehackers/new-repository/tags",
    "blobs_url": "https://api.github.com/repos/baxterandthehackers/new-repository/git/blobs{/sha}",
    "git_tags_url": "https://api.github.com/repos/baxterandthehackers/new-repository/git/tags{/sha}",
    "git_refs_url": "https://api.github.com/repos/baxterandthehackers/new-repository/git/refs{/sha}",
    "trees_url": "https://api.github.com/repos/baxterandthehackers/new-repository/git/trees{/sha}",
    "statuses_url": "https://api.github.com/repos/baxterandthehackers/new-repository/statuses/{sha}",
    "languages_url": "https://api.github.com/repos/baxterandthehackers/new-repository/languages",
    "stargazers_url": "https://api.github.com/repos/baxterandthehackers/new-repository/stargazers",
    "contributors_url": "https://api.github.com/repos/baxterandthehackers/new-repository/contributors",
    "subscribers_url": "https://api.github.com/repos/baxterandthehackers/new-repository/subscribers",
    "subscription_url": "https://api.github.com/repos/baxterandthehackers/new-repository/subscription",
    "commits_url": "https://api.github.com/repos/baxterandthehackers/new-repository/commits{/sha}",
    "git_commits_url": "https://api.github.com/repos/baxterandthehackers/new-repository/git/commits{/sha}",
    "comments_url": "https://api.github.com/repos/baxterandthehackers/new-repository/comments{/number}",
    "issue_comment_url": "https://api.github.com/repos/baxterandthehackers/new-repository/issues/comments/{number}",
    "contents_url": "https://api.github.com/repos/baxterandthehackers/new-repository/contents/{+path}",
    "compare_url": "https://api.github.com/repos/baxterandthehackers/new-repository/compare/{base}...{head}",
    "merges_url": "https://api.github.com/repos/baxterandthehackers/new-repository/merges",
    "archive_url": "https://api.github.com/repos/baxterandthehackers/new-repository/{archive_format}{/ref}",
    "downloads_url": "https://api.github.com/repos/baxterandthehackers/new-repository/downloads",
    "issues_url": "https://api.github.com/repos/baxterandthehackers/new-repository/issues{/number}",
    "pulls_url": "https://api.github.com/repos/baxterandthehackers/new-repository/pulls{/number}",
    "milestones_url": "https://api.github.com/repos/baxterandthehackers/new-repository/milestones{/number}",
    "notifications_url": "https://api.github.com/repos/baxterandthehackers/new-repository/notifications{?since,all,participating}",
    "labels_url": "https://api.github.com/repos/baxterandthehackers/new-repository/labels{/name}",
    "releases_url": "https://api.github.com/repos/baxterandthehackers/new-repository/releases{/id}",
    "created_at": "2014-12-03T16:39:25Z",
    "updated_at": "2014-12-03T16:39:25Z",
    "pushed_at": "2014-12-03T16:39:25Z",
    "git_url": "git://github.com/baxterandthehackers/new-repository.git",
    "ssh_url": "git@github.com:baxterandthehackers/new-repository.git",
    "clone_url": "https://github.com/baxterandthehackers/new-repository.git",
    "svn_url": "https://github.com/baxterandthehackers/new-repository",
    "homepage": null,
    "size": 0,
    "stargazers_count": 0,
    "watchers_count": 0,
    "language": null,
    "has_issues": true,
    "has_downloads": true,
    "has_wiki": true,
    "has_pages": false,
    "forks_count": 0,
    "mirror_url": null,
    "open_issues_count": 0,
    "forks": 0,
    "open_issues": 0,
    "watchers": 0,
    "default_branch": "master"
  },
  "organization": {
    "login": "baxterandthehackers",
    "id": 7649605,
    "url": "https://api.github.com/orgs/baxterandthehackers",
    "repos_url": "https://api.github.com/orgs/baxterandthehackers/repos",
    "events_url": "https://api.github.com/orgs/baxterandthehackers/events",
    "members_url": "https://api.github.com/orgs/baxterandthehackers/members{/member}",
    "public_members_url": "https://api.github.com/orgs/baxterandthehackers/public_members{/member}",
    "avatar_url": "https://avatars.githubusercontent.com/u/7649605?v=2"
  },
  "sender": {
    "login": "baxterthehacker",
    "id": 6752317,
    "avatar_url": "https://avatars.githubusercontent.com/u/6752317?v=2",
    "gravatar_id": "",
    "url": "https://api.github.com/users/baxterthehacker",
    "html_url": "https://github.com/baxterthehacker",
    "followers_url": "https://api.github.com/users/baxterthehacker/followers",
    "following_url": "https://api.github.com/users/baxterthehacker/following{/other_user}",
    "gists_url": "https://api.github.com/users/baxterthehacker/gists{/gist_id}",
    "starred_url": "https://api.github.com/users/baxterthehacker/starred{/owner}{/repo}",
    "subscriptions_url": "https://api.github.com/users/baxterthehacker/subscriptions",
    "organizations_url": "https://api.github.com/users/baxterthehacker/orgs",
    "repos_url": "https://api.github.com/users/baxterthehacker/repos",
    "events_url": "https://api.github.com/users/baxterthehacker/events{/privacy}",
    "received_events_url": "https://api.github.com/users/baxterthehacker/received_events",
    "type": "User",
    "site_admin": false
  }
}

StatusEvent

Triggered when the status of a Git commit changes.

Events of this type are not visible in timelines. These events are only used to trigger hooks.

Events API payload

Key Type Description
sha string The Commit SHA.
state string The new state. Can be pending, success, failure, or error.
description string The optional human-readable description added to the status.
target_url string The optional link added to the status.
branches array An array of branch objects containing the status' SHA. Each branch contains the given SHA, but the SHA may or may not be the head of the branch. The array includes a maximum of 10 branches.

Webhook event name

status

Webhook payload example

{
  "id": 214015194,
  "sha": "9049f1265b7d61be4a8904a9a27120d2064dab3b",
  "name": "baxterthehacker/public-repo",
  "target_url": null,
  "context": "default",
  "description": null,
  "state": "success",
  "commit": {
    "sha": "9049f1265b7d61be4a8904a9a27120d2064dab3b",
    "commit": {
      "author": {
        "name": "baxterthehacker",
        "email": "baxterthehacker@users.noreply.github.com",
        "date": "2015-05-05T23:40:12Z"
      },
      "committer": {
        "name": "baxterthehacker",
        "email": "baxterthehacker@users.noreply.github.com",
        "date": "2015-05-05T23:40:12Z"
      },
      "message": "Initial commit",
      "tree": {
        "sha": "02b49ad0ba4f1acd9f06531b21e16a4ac5d341d0",
        "url": "https://api.github.com/repos/baxterthehacker/public-repo/git/trees/02b49ad0ba4f1acd9f06531b21e16a4ac5d341d0"
      },
      "url": "https://api.github.com/repos/baxterthehacker/public-repo/git/commits/9049f1265b7d61be4a8904a9a27120d2064dab3b",
      "comment_count": 1
    },
    "url": "https://api.github.com/repos/baxterthehacker/public-repo/commits/9049f1265b7d61be4a8904a9a27120d2064dab3b",
    "html_url": "https://github.com/baxterthehacker/public-repo/commit/9049f1265b7d61be4a8904a9a27120d2064dab3b",
    "comments_url": "https://api.github.com/repos/baxterthehacker/public-repo/commits/9049f1265b7d61be4a8904a9a27120d2064dab3b/comments",
    "author": {
      "login": "baxterthehacker",
      "id": 6752317,
      "avatar_url": "https://avatars.githubusercontent.com/u/6752317?v=3",
      "gravatar_id": "",
      "url": "https://api.github.com/users/baxterthehacker",
      "html_url": "https://github.com/baxterthehacker",
      "followers_url": "https://api.github.com/users/baxterthehacker/followers",
      "following_url": "https://api.github.com/users/baxterthehacker/following{/other_user}",
      "gists_url": "https://api.github.com/users/baxterthehacker/gists{/gist_id}",
      "starred_url": "https://api.github.com/users/baxterthehacker/starred{/owner}{/repo}",
      "subscriptions_url": "https://api.github.com/users/baxterthehacker/subscriptions",
      "organizations_url": "https://api.github.com/users/baxterthehacker/orgs",
      "repos_url": "https://api.github.com/users/baxterthehacker/repos",
      "events_url": "https://api.github.com/users/baxterthehacker/events{/privacy}",
      "received_events_url": "https://api.github.com/users/baxterthehacker/received_events",
      "type": "User",
      "site_admin": false
    },
    "committer": {
      "login": "baxterthehacker",
      "id": 6752317,
      "avatar_url": "https://avatars.githubusercontent.com/u/6752317?v=3",
      "gravatar_id": "",
      "url": "https://api.github.com/users/baxterthehacker",
      "html_url": "https://github.com/baxterthehacker",
      "followers_url": "https://api.github.com/users/baxterthehacker/followers",
      "following_url": "https://api.github.com/users/baxterthehacker/following{/other_user}",
      "gists_url": "https://api.github.com/users/baxterthehacker/gists{/gist_id}",
      "starred_url": "https://api.github.com/users/baxterthehacker/starred{/owner}{/repo}",
      "subscriptions_url": "https://api.github.com/users/baxterthehacker/subscriptions",
      "organizations_url": "https://api.github.com/users/baxterthehacker/orgs",
      "repos_url": "https://api.github.com/users/baxterthehacker/repos",
      "events_url": "https://api.github.com/users/baxterthehacker/events{/privacy}",
      "received_events_url": "https://api.github.com/users/baxterthehacker/received_events",
      "type": "User",
      "site_admin": false
    },
    "parents": [

    ]
  },
  "branches": [
    {
      "name": "master",
      "commit": {
        "sha": "9049f1265b7d61be4a8904a9a27120d2064dab3b",
        "url": "https://api.github.com/repos/baxterthehacker/public-repo/commits/9049f1265b7d61be4a8904a9a27120d2064dab3b"
      }
    },
    {
      "name": "changes",
      "commit": {
        "sha": "0d1a26e67d8f5eaf1f6ba5c57fc3c7d91ac0fd1c",
        "url": "https://api.github.com/repos/baxterthehacker/public-repo/commits/0d1a26e67d8f5eaf1f6ba5c57fc3c7d91ac0fd1c"
      }
    },
    {
      "name": "gh-pages",
      "commit": {
        "sha": "b11bb7545ac14abafc6191a0481b0d961e7793c6",
        "url": "https://api.github.com/repos/baxterthehacker/public-repo/commits/b11bb7545ac14abafc6191a0481b0d961e7793c6"
      }
    }
  ],
  "created_at": "2015-05-05T23:40:39Z",
  "updated_at": "2015-05-05T23:40:39Z",
  "repository": {
    "id": 35129377,
    "name": "public-repo",
    "full_name": "baxterthehacker/public-repo",
    "owner": {
      "login": "baxterthehacker",
      "id": 6752317,
      "avatar_url": "https://avatars.githubusercontent.com/u/6752317?v=3",
      "gravatar_id": "",
      "url": "https://api.github.com/users/baxterthehacker",
      "html_url": "https://github.com/baxterthehacker",
      "followers_url": "https://api.github.com/users/baxterthehacker/followers",
      "following_url": "https://api.github.com/users/baxterthehacker/following{/other_user}",
      "gists_url": "https://api.github.com/users/baxterthehacker/gists{/gist_id}",
      "starred_url": "https://api.github.com/users/baxterthehacker/starred{/owner}{/repo}",
      "subscriptions_url": "https://api.github.com/users/baxterthehacker/subscriptions",
      "organizations_url": "https://api.github.com/users/baxterthehacker/orgs",
      "repos_url": "https://api.github.com/users/baxterthehacker/repos",
      "events_url": "https://api.github.com/users/baxterthehacker/events{/privacy}",
      "received_events_url": "https://api.github.com/users/baxterthehacker/received_events",
      "type": "User",
      "site_admin": false
    },
    "private": false,
    "html_url": "https://github.com/baxterthehacker/public-repo",
    "description": "",
    "fork": false,
    "url": "https://api.github.com/repos/baxterthehacker/public-repo",
    "forks_url": "https://api.github.com/repos/baxterthehacker/public-repo/forks",
    "keys_url": "https://api.github.com/repos/baxterthehacker/public-repo/keys{/key_id}",
    "collaborators_url": "https://api.github.com/repos/baxterthehacker/public-repo/collaborators{/collaborator}",
    "teams_url": "https://api.github.com/repos/baxterthehacker/public-repo/teams",
    "hooks_url": "https://api.github.com/repos/baxterthehacker/public-repo/hooks",
    "issue_events_url": "https://api.github.com/repos/baxterthehacker/public-repo/issues/events{/number}",
    "events_url": "https://api.github.com/repos/baxterthehacker/public-repo/events",
    "assignees_url": "https://api.github.com/repos/baxterthehacker/public-repo/assignees{/user}",
    "branches_url": "https://api.github.com/repos/baxterthehacker/public-repo/branches{/branch}",
    "tags_url": "https://api.github.com/repos/baxterthehacker/public-repo/tags",
    "blobs_url": "https://api.github.com/repos/baxterthehacker/public-repo/git/blobs{/sha}",
    "git_tags_url": "https://api.github.com/repos/baxterthehacker/public-repo/git/tags{/sha}",
    "git_refs_url": "https://api.github.com/repos/baxterthehacker/public-repo/git/refs{/sha}",
    "trees_url": "https://api.github.com/repos/baxterthehacker/public-repo/git/trees{/sha}",
    "statuses_url": "https://api.github.com/repos/baxterthehacker/public-repo/statuses/{sha}",
    "languages_url": "https://api.github.com/repos/baxterthehacker/public-repo/languages",
    "stargazers_url": "https://api.github.com/repos/baxterthehacker/public-repo/stargazers",
    "contributors_url": "https://api.github.com/repos/baxterthehacker/public-repo/contributors",
    "subscribers_url": "https://api.github.com/repos/baxterthehacker/public-repo/subscribers",
    "subscription_url": "https://api.github.com/repos/baxterthehacker/public-repo/subscription",
    "commits_url": "https://api.github.com/repos/baxterthehacker/public-repo/commits{/sha}",
    "git_commits_url": "https://api.github.com/repos/baxterthehacker/public-repo/git/commits{/sha}",
    "comments_url": "https://api.github.com/repos/baxterthehacker/public-repo/comments{/number}",
    "issue_comment_url": "https://api.github.com/repos/baxterthehacker/public-repo/issues/comments{/number}",
    "contents_url": "https://api.github.com/repos/baxterthehacker/public-repo/contents/{+path}",
    "compare_url": "https://api.github.com/repos/baxterthehacker/public-repo/compare/{base}...{head}",
    "merges_url": "https://api.github.com/repos/baxterthehacker/public-repo/merges",
    "archive_url": "https://api.github.com/repos/baxterthehacker/public-repo/{archive_format}{/ref}",
    "downloads_url": "https://api.github.com/repos/baxterthehacker/public-repo/downloads",
    "issues_url": "https://api.github.com/repos/baxterthehacker/public-repo/issues{/number}",
    "pulls_url": "https://api.github.com/repos/baxterthehacker/public-repo/pulls{/number}",
    "milestones_url": "https://api.github.com/repos/baxterthehacker/public-repo/milestones{/number}",
    "notifications_url": "https://api.github.com/repos/baxterthehacker/public-repo/notifications{?since,all,participating}",
    "labels_url": "https://api.github.com/repos/baxterthehacker/public-repo/labels{/name}",
    "releases_url": "https://api.github.com/repos/baxterthehacker/public-repo/releases{/id}",
    "created_at": "2015-05-05T23:40:12Z",
    "updated_at": "2015-05-05T23:40:30Z",
    "pushed_at": "2015-05-05T23:40:39Z",
    "git_url": "git://github.com/baxterthehacker/public-repo.git",
    "ssh_url": "git@github.com:baxterthehacker/public-repo.git",
    "clone_url": "https://github.com/baxterthehacker/public-repo.git",
    "svn_url": "https://github.com/baxterthehacker/public-repo",
    "homepage": null,
    "size": 0,
    "stargazers_count": 0,
    "watchers_count": 0,
    "language": null,
    "has_issues": true,
    "has_downloads": true,
    "has_wiki": true,
    "has_pages": true,
    "forks_count": 0,
    "mirror_url": null,
    "open_issues_count": 2,
    "forks": 0,
    "open_issues": 2,
    "watchers": 0,
    "default_branch": "master"
  },
  "sender": {
    "login": "baxterthehacker",
    "id": 6752317,
    "avatar_url": "https://avatars.githubusercontent.com/u/6752317?v=3",
    "gravatar_id": "",
    "url": "https://api.github.com/users/baxterthehacker",
    "html_url": "https://github.com/baxterthehacker",
    "followers_url": "https://api.github.com/users/baxterthehacker/followers",
    "following_url": "https://api.github.com/users/baxterthehacker/following{/other_user}",
    "gists_url": "https://api.github.com/users/baxterthehacker/gists{/gist_id}",
    "starred_url": "https://api.github.com/users/baxterthehacker/starred{/owner}{/repo}",
    "subscriptions_url": "https://api.github.com/users/baxterthehacker/subscriptions",
    "organizations_url": "https://api.github.com/users/baxterthehacker/orgs",
    "repos_url": "https://api.github.com/users/baxterthehacker/repos",
    "events_url": "https://api.github.com/users/baxterthehacker/events{/privacy}",
    "received_events_url": "https://api.github.com/users/baxterthehacker/received_events",
    "type": "User",
    "site_admin": false
  }
}

TeamEvent

Triggered when an organization's team is created or deleted.

Events of this type are not visible in timelines. These events are only used to trigger organization hooks.

Events API payload

Key Type Description
action string The action that was performed. Can be one of created, deleted, edited, added_to_repository, or removed_from_repository.
team object The team itself.
changes object The changes to the team if the action was "edited".
changes[description][from] string The previous version of the description if the action was edited.
changes[name][from] string The previous version of the name if the action was edited.
changes[privacy][from] string The previous version of the team's privacy if the action was edited.
changes[repository][permissions][from][admin] boolean The previous version of the team member's admin permission on a repository, if the action was edited.
changes[repository][permissions][from][pull] boolean The previous version of the team member's pull permission on a repository, if the action was edited.
changes[repository][permissions][from][push] boolean The previous version of the team member's push permission on a repository, if the action was edited.
repository object The repository that was added or removed from to the team's purview if the action was added_to_repository, removed_from_repository, or edited. For edited actions, repository also contains the team's new permission levels for the repository.

Webhook event name

team

Webhook payload example

{
  "action":"created",
  "team":{
    "name":"team baxter",
    "id":2175394,
    "slug":"team-baxter",
    "description":"",
    "privacy":"secret",
    "url":"https:/api.github.com/teams/2175394",
    "members_url":"https:/api.github.com/teams/2175394/members{/member}",
    "repositories_url":"https:/api.github.com/teams/2175394/repos",
    "permission":"pull"
  },
  "organization":{
    "login":"baxterandthehackers",
    "id":4312013,
    "url":"https://api.github.com/orgs/baxterandthehackers",
    "repos_url":"https://api.github.com/orgs/baxterandthehackers/repos",
    "events_url":"https://api.github.com/orgs/baxterandthehackers/events",
    "hooks_url":"https://api.github.com/orgs/baxterandthehackers/hooks",
    "issues_url":"https://api.github.com/orgs/baxterandthehackers/issues",
    "members_url":"https://api.github.com/orgs/baxterandthehackers/members{/member}",
    "public_members_url":"https://api.github.com/orgs/baxterandthehackers/public_members{/member}",
    "avatar_url":"https://avatars.githubusercontent.com/u/4312013?v=3",
    "description":""
  },
  "sender": {
    "login": "baxterthehacker",
    "id": 6752317,
    "avatar_url": "https://avatars.githubusercontent.com/u/6752317?v=3",
    "gravatar_id": "",
    "url": "https://api.github.com/users/baxterthehacker",
    "html_url": "https://github.com/baxterthehacker",
    "followers_url": "https://api.github.com/users/baxterthehacker/followers",
    "following_url": "https://api.github.com/users/baxterthehacker/following{/other_user}",
    "gists_url": "https://api.github.com/users/baxterthehacker/gists{/gist_id}",
    "starred_url": "https://api.github.com/users/baxterthehacker/starred{/owner}{/repo}",
    "subscriptions_url": "https://api.github.com/users/baxterthehacker/subscriptions",
    "organizations_url": "https://api.github.com/users/baxterthehacker/orgs",
    "repos_url": "https://api.github.com/users/baxterthehacker/repos",
    "events_url": "https://api.github.com/users/baxterthehacker/events{/privacy}",
    "received_events_url": "https://api.github.com/users/baxterthehacker/received_events",
    "type": "User",
    "site_admin": false
  }
}

TeamAddEvent

Triggered when a repository is added to a team.

Events of this type are not visible in timelines. These events are only used to trigger hooks.

Events API payload

Key Type Description
team object The team that was modified. Note: older events may not include this in the payload.
repository object The repository that was added to this team.

Webhook event name

team_add

Webhook payload example

{
  "team": {
    "name": "github",
    "id": 836012,
    "slug": "github",
    "description": "",
    "permission": "pull",
    "url": "https://api.github.com/teams/836012",
    "members_url": "https://api.github.com/teams/836012/members{/member}",
    "repositories_url": "https://api.github.com/teams/836012/repos"
  },
  "repository": {
    "id": 35129393,
    "name": "public-repo",
    "full_name": "baxterandthehackers/public-repo",
    "owner": {
      "login": "baxterandthehackers",
      "id": 7649605,
      "avatar_url": "https://avatars.githubusercontent.com/u/7649605?v=3",
      "gravatar_id": "",
      "url": "https://api.github.com/users/baxterandthehackers",
      "html_url": "https://github.com/baxterandthehackers",
      "followers_url": "https://api.github.com/users/baxterandthehackers/followers",
      "following_url": "https://api.github.com/users/baxterandthehackers/following{/other_user}",
      "gists_url": "https://api.github.com/users/baxterandthehackers/gists{/gist_id}",
      "starred_url": "https://api.github.com/users/baxterandthehackers/starred{/owner}{/repo}",
      "subscriptions_url": "https://api.github.com/users/baxterandthehackers/subscriptions",
      "organizations_url": "https://api.github.com/users/baxterandthehackers/orgs",
      "repos_url": "https://api.github.com/users/baxterandthehackers/repos",
      "events_url": "https://api.github.com/users/baxterandthehackers/events{/privacy}",
      "received_events_url": "https://api.github.com/users/baxterandthehackers/received_events",
      "type": "Organization",
      "site_admin": false
    },
    "private": false,
    "html_url": "https://github.com/baxterandthehackers/public-repo",
    "description": "",
    "fork": true,
    "url": "https://api.github.com/repos/baxterandthehackers/public-repo",
    "forks_url": "https://api.github.com/repos/baxterandthehackers/public-repo/forks",
    "keys_url": "https://api.github.com/repos/baxterandthehackers/public-repo/keys{/key_id}",
    "collaborators_url": "https://api.github.com/repos/baxterandthehackers/public-repo/collaborators{/collaborator}",
    "teams_url": "https://api.github.com/repos/baxterandthehackers/public-repo/teams",
    "hooks_url": "https://api.github.com/repos/baxterandthehackers/public-repo/hooks",
    "issue_events_url": "https://api.github.com/repos/baxterandthehackers/public-repo/issues/events{/number}",
    "events_url": "https://api.github.com/repos/baxterandthehackers/public-repo/events",
    "assignees_url": "https://api.github.com/repos/baxterandthehackers/public-repo/assignees{/user}",
    "branches_url": "https://api.github.com/repos/baxterandthehackers/public-repo/branches{/branch}",
    "tags_url": "https://api.github.com/repos/baxterandthehackers/public-repo/tags",
    "blobs_url": "https://api.github.com/repos/baxterandthehackers/public-repo/git/blobs{/sha}",
    "git_tags_url": "https://api.github.com/repos/baxterandthehackers/public-repo/git/tags{/sha}",
    "git_refs_url": "https://api.github.com/repos/baxterandthehackers/public-repo/git/refs{/sha}",
    "trees_url": "https://api.github.com/repos/baxterandthehackers/public-repo/git/trees{/sha}",
    "statuses_url": "https://api.github.com/repos/baxterandthehackers/public-repo/statuses/{sha}",
    "languages_url": "https://api.github.com/repos/baxterandthehackers/public-repo/languages",
    "stargazers_url": "https://api.github.com/repos/baxterandthehackers/public-repo/stargazers",
    "contributors_url": "https://api.github.com/repos/baxterandthehackers/public-repo/contributors",
    "subscribers_url": "https://api.github.com/repos/baxterandthehackers/public-repo/subscribers",
    "subscription_url": "https://api.github.com/repos/baxterandthehackers/public-repo/subscription",
    "commits_url": "https://api.github.com/repos/baxterandthehackers/public-repo/commits{/sha}",
    "git_commits_url": "https://api.github.com/repos/baxterandthehackers/public-repo/git/commits{/sha}",
    "comments_url": "https://api.github.com/repos/baxterandthehackers/public-repo/comments{/number}",
    "issue_comment_url": "https://api.github.com/repos/baxterandthehackers/public-repo/issues/comments{/number}",
    "contents_url": "https://api.github.com/repos/baxterandthehackers/public-repo/contents/{+path}",
    "compare_url": "https://api.github.com/repos/baxterandthehackers/public-repo/compare/{base}...{head}",
    "merges_url": "https://api.github.com/repos/baxterandthehackers/public-repo/merges",
    "archive_url": "https://api.github.com/repos/baxterandthehackers/public-repo/{archive_format}{/ref}",
    "downloads_url": "https://api.github.com/repos/baxterandthehackers/public-repo/downloads",
    "issues_url": "https://api.github.com/repos/baxterandthehackers/public-repo/issues{/number}",
    "pulls_url": "https://api.github.com/repos/baxterandthehackers/public-repo/pulls{/number}",
    "milestones_url": "https://api.github.com/repos/baxterandthehackers/public-repo/milestones{/number}",
    "notifications_url": "https://api.github.com/repos/baxterandthehackers/public-repo/notifications{?since,all,participating}",
    "labels_url": "https://api.github.com/repos/baxterandthehackers/public-repo/labels{/name}",
    "releases_url": "https://api.github.com/repos/baxterandthehackers/public-repo/releases{/id}",
    "created_at": "2015-05-05T23:40:30Z",
    "updated_at": "2015-05-05T23:40:30Z",
    "pushed_at": "2015-05-05T23:40:27Z",
    "git_url": "git://github.com/baxterandthehackers/public-repo.git",
    "ssh_url": "git@github.com:baxterandthehackers/public-repo.git",
    "clone_url": "https://github.com/baxterandthehackers/public-repo.git",
    "svn_url": "https://github.com/baxterandthehackers/public-repo",
    "homepage": null,
    "size": 0,
    "stargazers_count": 0,
    "watchers_count": 0,
    "language": null,
    "has_issues": false,
    "has_downloads": true,
    "has_wiki": true,
    "has_pages": true,
    "forks_count": 0,
    "mirror_url": null,
    "open_issues_count": 0,
    "forks": 0,
    "open_issues": 0,
    "watchers": 0,
    "default_branch": "master"
  },
  "organization": {
    "login": "baxterandthehackers",
    "id": 7649605,
    "url": "https://api.github.com/orgs/baxterandthehackers",
    "repos_url": "https://api.github.com/orgs/baxterandthehackers/repos",
    "events_url": "https://api.github.com/orgs/baxterandthehackers/events",
    "members_url": "https://api.github.com/orgs/baxterandthehackers/members{/member}",
    "public_members_url": "https://api.github.com/orgs/baxterandthehackers/public_members{/member}",
    "avatar_url": "https://avatars.githubusercontent.com/u/7649605?v=3",
    "description": null
  },
  "sender": {
    "login": "baxterandthehackers",
    "id": 7649605,
    "avatar_url": "https://avatars.githubusercontent.com/u/7649605?v=3",
    "gravatar_id": "",
    "url": "https://api.github.com/users/baxterandthehackers",
    "html_url": "https://github.com/baxterandthehackers",
    "followers_url": "https://api.github.com/users/baxterandthehackers/followers",
    "following_url": "https://api.github.com/users/baxterandthehackers/following{/other_user}",
    "gists_url": "https://api.github.com/users/baxterandthehackers/gists{/gist_id}",
    "starred_url": "https://api.github.com/users/baxterandthehackers/starred{/owner}{/repo}",
    "subscriptions_url": "https://api.github.com/users/baxterandthehackers/subscriptions",
    "organizations_url": "https://api.github.com/users/baxterandthehackers/orgs",
    "repos_url": "https://api.github.com/users/baxterandthehackers/repos",
    "events_url": "https://api.github.com/users/baxterandthehackers/events{/privacy}",
    "received_events_url": "https://api.github.com/users/baxterandthehackers/received_events",
    "type": "Organization",
    "site_admin": false
  }
}

WatchEvent

The WatchEvent is related to starring a repository, not watching. See this API blog post for an explanation.

The event’s actor is the user who starred a repository, and the event’s repository is the repository that was starred.

Events API payload

Key Type Description
action string The action that was performed. Currently, can only be started.

Webhook event name

watch

Webhook payload example

{
  "action": "started",
  "repository": {
    "id": 35129377,
    "name": "public-repo",
    "full_name": "baxterthehacker/public-repo",
    "owner": {
      "login": "baxterthehacker",
      "id": 6752317,
      "avatar_url": "https://avatars.githubusercontent.com/u/6752317?v=3",
      "gravatar_id": "",
      "url": "https://api.github.com/users/baxterthehacker",
      "html_url": "https://github.com/baxterthehacker",
      "followers_url": "https://api.github.com/users/baxterthehacker/followers",
      "following_url": "https://api.github.com/users/baxterthehacker/following{/other_user}",
      "gists_url": "https://api.github.com/users/baxterthehacker/gists{/gist_id}",
      "starred_url": "https://api.github.com/users/baxterthehacker/starred{/owner}{/repo}",
      "subscriptions_url": "https://api.github.com/users/baxterthehacker/subscriptions",
      "organizations_url": "https://api.github.com/users/baxterthehacker/orgs",
      "repos_url": "https://api.github.com/users/baxterthehacker/repos",
      "events_url": "https://api.github.com/users/baxterthehacker/events{/privacy}",
      "received_events_url": "https://api.github.com/users/baxterthehacker/received_events",
      "type": "User",
      "site_admin": false
    },
    "private": false,
    "html_url": "https://github.com/baxterthehacker/public-repo",
    "description": "",
    "fork": false,
    "url": "https://api.github.com/repos/baxterthehacker/public-repo",
    "forks_url": "https://api.github.com/repos/baxterthehacker/public-repo/forks",
    "keys_url": "https://api.github.com/repos/baxterthehacker/public-repo/keys{/key_id}",
    "collaborators_url": "https://api.github.com/repos/baxterthehacker/public-repo/collaborators{/collaborator}",
    "teams_url": "https://api.github.com/repos/baxterthehacker/public-repo/teams",
    "hooks_url": "https://api.github.com/repos/baxterthehacker/public-repo/hooks",
    "issue_events_url": "https://api.github.com/repos/baxterthehacker/public-repo/issues/events{/number}",
    "events_url": "https://api.github.com/repos/baxterthehacker/public-repo/events",
    "assignees_url": "https://api.github.com/repos/baxterthehacker/public-repo/assignees{/user}",
    "branches_url": "https://api.github.com/repos/baxterthehacker/public-repo/branches{/branch}",
    "tags_url": "https://api.github.com/repos/baxterthehacker/public-repo/tags",
    "blobs_url": "https://api.github.com/repos/baxterthehacker/public-repo/git/blobs{/sha}",
    "git_tags_url": "https://api.github.com/repos/baxterthehacker/public-repo/git/tags{/sha}",
    "git_refs_url": "https://api.github.com/repos/baxterthehacker/public-repo/git/refs{/sha}",
    "trees_url": "https://api.github.com/repos/baxterthehacker/public-repo/git/trees{/sha}",
    "statuses_url": "https://api.github.com/repos/baxterthehacker/public-repo/statuses/{sha}",
    "languages_url": "https://api.github.com/repos/baxterthehacker/public-repo/languages",
    "stargazers_url": "https://api.github.com/repos/baxterthehacker/public-repo/stargazers",
    "contributors_url": "https://api.github.com/repos/baxterthehacker/public-repo/contributors",
    "subscribers_url": "https://api.github.com/repos/baxterthehacker/public-repo/subscribers",
    "subscription_url": "https://api.github.com/repos/baxterthehacker/public-repo/subscription",
    "commits_url": "https://api.github.com/repos/baxterthehacker/public-repo/commits{/sha}",
    "git_commits_url": "https://api.github.com/repos/baxterthehacker/public-repo/git/commits{/sha}",
    "comments_url": "https://api.github.com/repos/baxterthehacker/public-repo/comments{/number}",
    "issue_comment_url": "https://api.github.com/repos/baxterthehacker/public-repo/issues/comments{/number}",
    "contents_url": "https://api.github.com/repos/baxterthehacker/public-repo/contents/{+path}",
    "compare_url": "https://api.github.com/repos/baxterthehacker/public-repo/compare/{base}...{head}",
    "merges_url": "https://api.github.com/repos/baxterthehacker/public-repo/merges",
    "archive_url": "https://api.github.com/repos/baxterthehacker/public-repo/{archive_format}{/ref}",
    "downloads_url": "https://api.github.com/repos/baxterthehacker/public-repo/downloads",
    "issues_url": "https://api.github.com/repos/baxterthehacker/public-repo/issues{/number}",
    "pulls_url": "https://api.github.com/repos/baxterthehacker/public-repo/pulls{/number}",
    "milestones_url": "https://api.github.com/repos/baxterthehacker/public-repo/milestones{/number}",
    "notifications_url": "https://api.github.com/repos/baxterthehacker/public-repo/notifications{?since,all,participating}",
    "labels_url": "https://api.github.com/repos/baxterthehacker/public-repo/labels{/name}",
    "releases_url": "https://api.github.com/repos/baxterthehacker/public-repo/releases{/id}",
    "created_at": "2015-05-05T23:40:12Z",
    "updated_at": "2015-05-05T23:40:30Z",
    "pushed_at": "2015-05-05T23:40:27Z",
    "git_url": "git://github.com/baxterthehacker/public-repo.git",
    "ssh_url": "git@github.com:baxterthehacker/public-repo.git",
    "clone_url": "https://github.com/baxterthehacker/public-repo.git",
    "svn_url": "https://github.com/baxterthehacker/public-repo",
    "homepage": null,
    "size": 0,
    "stargazers_count": 0,
    "watchers_count": 0,
    "language": null,
    "has_issues": true,
    "has_downloads": true,
    "has_wiki": true,
    "has_pages": true,
    "forks_count": 0,
    "mirror_url": null,
    "open_issues_count": 2,
    "forks": 0,
    "open_issues": 2,
    "watchers": 0,
    "default_branch": "master"
  },
  "sender": {
    "login": "baxterthehacker",
    "id": 6752317,
    "avatar_url": "https://avatars.githubusercontent.com/u/6752317?v=3",
    "gravatar_id": "",
    "url": "https://api.github.com/users/baxterthehacker",
    "html_url": "https://github.com/baxterthehacker",
    "followers_url": "https://api.github.com/users/baxterthehacker/followers",
    "following_url": "https://api.github.com/users/baxterthehacker/following{/other_user}",
    "gists_url": "https://api.github.com/users/baxterthehacker/gists{/gist_id}",
    "starred_url": "https://api.github.com/users/baxterthehacker/starred{/owner}{/repo}",
    "subscriptions_url": "https://api.github.com/users/baxterthehacker/subscriptions",
    "organizations_url": "https://api.github.com/users/baxterthehacker/orgs",
    "repos_url": "https://api.github.com/users/baxterthehacker/repos",
    "events_url": "https://api.github.com/users/baxterthehacker/events{/privacy}",
    "received_events_url": "https://api.github.com/users/baxterthehacker/received_events",
    "type": "User",
    "site_admin": false
  }
}
tmp/developer.github.com/v3/activity/feeds/index.html Feeds | GitHub Developer Guide

Feeds

List Feeds

GitHub provides several timeline resources in Atom format. The Feeds API lists all the feeds available to the authenticated user:

  • Timeline: The GitHub global public timeline
  • User: The public timeline for any user, using URI template
  • Current user public: The public timeline for the authenticated user
  • Current user: The private timeline for the authenticated user
  • Current user actor: The private timeline for activity created by the authenticated user
  • Current user organizations: The private timeline for the organizations the authenticated user is a member of.

Note: Private feeds are only returned when authenticating via Basic Auth since current feed URIs use the older, non revocable auth tokens.

GET /feeds

Response

Status: 200 OK
{
  "timeline_url": "https://github.com/timeline",
  "user_url": "https://github.com/{user}",
  "current_user_public_url": "https://github.com/defunkt",
  "current_user_url": "https://github.com/defunkt.private?token=abc123",
  "current_user_actor_url": "https://github.com/defunkt.private.actor?token=abc123",
  "current_user_organization_url": "",
  "current_user_organization_urls": [
    "https://github.com/organizations/github/defunkt.private.atom?token=abc123"
  ],
  "_links": {
    "timeline": {
      "href": "https://github.com/timeline",
      "type": "application/atom+xml"
    },
    "user": {
      "href": "https://github.com/{user}",
      "type": "application/atom+xml"
    },
    "current_user_public": {
      "href": "https://github.com/defunkt",
      "type": "application/atom+xml"
    },
    "current_user": {
      "href": "https://github.com/defunkt.private?token=abc123",
      "type": "application/atom+xml"
    },
    "current_user_actor": {
      "href": "https://github.com/defunkt.private.actor?token=abc123",
      "type": "application/atom+xml"
    },
    "current_user_organization": {
      "href": "",
      "type": ""
    },
    "current_user_organizations": [
      {
        "href": "https://github.com/organizations/github/defunkt.private.atom?token=abc123",
        "type": "application/atom+xml"
      }
    ]
  }
}
tmp/developer.github.com/v3/activity/notifications/index.html Notifications | GitHub Developer Guide

Notifications

Users receive notifications for conversations in repositories they watch including:

  • Issues and their comments
  • Pull Requests and their comments
  • Comments on any commits

Notifications are also sent for conversations in unwatched repositories when the user is involved including:

  • @mentions
  • Issue assignments
  • Commits the user authors or commits
  • Any discussion in which the user actively participates

All Notification API calls require the notifications or repo API scopes. Doing this will give read-only access to some Issue/Commit content. You will still need the "repo" scope to access Issues and Commits from their respective endpoints.

Notifications come back as "threads". A Thread contains information about the current discussion of an Issue/PullRequest/Commit.

Notifications are optimized for polling with the "Last-Modified" header. If there are no new notifications, you will see a "304 Not Modified" response, leaving your current rate limit untouched. There is an "X-Poll-Interval" header that specifies how often (in seconds) you are allowed to poll. In times of high server load, the time may increase. Please obey the header.

# Add authentication to your requests
curl -I https://api.github.com/notifications
HTTP/1.1 200 OK
Last-Modified: Thu, 25 Oct 2012 15:16:27 GMT
X-Poll-Interval: 60

# Pass the Last-Modified header exactly
curl -I https://api.github.com/notifications
   -H "If-Modified-Since: Thu, 25 Oct 2012 15:16:27 GMT"
HTTP/1.1 304 Not Modified
X-Poll-Interval: 60

Notification Reasons

When retrieving responses from the Notifications API, each payload has a key titled reason. These correspond to events that trigger a notification.

Here's a list of potential reasons for receiving a notification:

Reason Name Description
assign You were assigned to the Issue.
author You created the thread.
comment You commented on the thread.
invitation You accepted an invitation to contribute to the repository.
manual You subscribed to the thread (via an Issue or Pull Request).
mention You were specifically @mentioned in the content.
state_change You changed the thread state (for example, closing an Issue or merging a Pull Request).
subscribed You're watching the repository.
team_mention You were on a team that was mentioned.

Note that the reason is modified on a per-thread basis, and can change, if the reason on a later notification is different.

For example, if you are the author of an issue, subsequent notifications on that issue will have a reason of author. If you're then @mentioned on the same issue, the notifications you fetch thereafter will have a reason of mention. The reason remains as mention, regardless of whether you're ever mentioned again.

List your notifications

List all notifications for the current user, sorted by most recently updated.

GET /notifications

Parameters

Name Type Description
all boolean If true, show notifications marked as read. Default: false
participating boolean If true, only shows notifications in which the user is directly participating or mentioned. Default: false
since string Only show notifications updated after the given time. This is a timestamp in ISO 8601 format: YYYY-MM-DDTHH:MM:SSZ. Default: Time.now
before string Only show notifications updated before the given time. This is a timestamp in ISO 8601 format: YYYY-MM-DDTHH:MM:SSZ.

Response

Status: 200 OK
Link: <https://api.github.com/resource?page=2>; rel="next",
      <https://api.github.com/resource?page=5>; rel="last"
[
  {
    "id": "1",
    "repository": {
      "id": 1296269,
      "owner": {
        "login": "octocat",
        "id": 1,
        "avatar_url": "https://github.com/images/error/octocat_happy.gif",
        "gravatar_id": "",
        "url": "https://api.github.com/users/octocat",
        "html_url": "https://github.com/octocat",
        "followers_url": "https://api.github.com/users/octocat/followers",
        "following_url": "https://api.github.com/users/octocat/following{/other_user}",
        "gists_url": "https://api.github.com/users/octocat/gists{/gist_id}",
        "starred_url": "https://api.github.com/users/octocat/starred{/owner}{/repo}",
        "subscriptions_url": "https://api.github.com/users/octocat/subscriptions",
        "organizations_url": "https://api.github.com/users/octocat/orgs",
        "repos_url": "https://api.github.com/users/octocat/repos",
        "events_url": "https://api.github.com/users/octocat/events{/privacy}",
        "received_events_url": "https://api.github.com/users/octocat/received_events",
        "type": "User",
        "site_admin": false
      },
      "name": "Hello-World",
      "full_name": "octocat/Hello-World",
      "description": "This your first repo!",
      "private": false,
      "fork": false,
      "url": "https://api.github.com/repos/octocat/Hello-World",
      "html_url": "https://github.com/octocat/Hello-World"
    },
    "subject": {
      "title": "Greetings",
      "url": "https://api.github.com/repos/octokit/octokit.rb/issues/123",
      "latest_comment_url": "https://api.github.com/repos/octokit/octokit.rb/issues/comments/123",
      "type": "Issue"
    },
    "reason": "subscribed",
    "unread": true,
    "updated_at": "2014-11-07T22:01:45Z",
    "last_read_at": "2014-11-07T22:01:45Z",
    "url": "https://api.github.com/notifications/threads/1"
  }
]

List your notifications in a repository

List all notifications for the current user.

GET /repos/:owner/:repo/notifications

Parameters

Name Type Description
all boolean If true, show notifications marked as read. Default: false
participating boolean If true, only shows notifications in which the user is directly participating or mentioned. Default: false
since string Only show notifications updated after the given time. This is a timestamp in ISO 8601 format: YYYY-MM-DDTHH:MM:SSZ. Default: Time.now
before string Only show notifications updated before the given time. This is a timestamp in ISO 8601 format: YYYY-MM-DDTHH:MM:SSZ.

Response

Status: 200 OK
Link: <https://api.github.com/resource?page=2>; rel="next",
      <https://api.github.com/resource?page=5>; rel="last"
[
  {
    "id": "1",
    "repository": {
      "id": 1296269,
      "owner": {
        "login": "octocat",
        "id": 1,
        "avatar_url": "https://github.com/images/error/octocat_happy.gif",
        "gravatar_id": "",
        "url": "https://api.github.com/users/octocat",
        "html_url": "https://github.com/octocat",
        "followers_url": "https://api.github.com/users/octocat/followers",
        "following_url": "https://api.github.com/users/octocat/following{/other_user}",
        "gists_url": "https://api.github.com/users/octocat/gists{/gist_id}",
        "starred_url": "https://api.github.com/users/octocat/starred{/owner}{/repo}",
        "subscriptions_url": "https://api.github.com/users/octocat/subscriptions",
        "organizations_url": "https://api.github.com/users/octocat/orgs",
        "repos_url": "https://api.github.com/users/octocat/repos",
        "events_url": "https://api.github.com/users/octocat/events{/privacy}",
        "received_events_url": "https://api.github.com/users/octocat/received_events",
        "type": "User",
        "site_admin": false
      },
      "name": "Hello-World",
      "full_name": "octocat/Hello-World",
      "description": "This your first repo!",
      "private": false,
      "fork": false,
      "url": "https://api.github.com/repos/octocat/Hello-World",
      "html_url": "https://github.com/octocat/Hello-World"
    },
    "subject": {
      "title": "Greetings",
      "url": "https://api.github.com/repos/octokit/octokit.rb/issues/123",
      "latest_comment_url": "https://api.github.com/repos/octokit/octokit.rb/issues/comments/123",
      "type": "Issue"
    },
    "reason": "subscribed",
    "unread": true,
    "updated_at": "2014-11-07T22:01:45Z",
    "last_read_at": "2014-11-07T22:01:45Z",
    "url": "https://api.github.com/notifications/threads/1"
  }
]

Mark as read

Marking a notification as "read" removes it from the default view on GitHub.

PUT /notifications

Parameters

Name Type Description
last_read_at string Describes the last point that notifications were checked. Anything updated since this time will not be updated. This is a timestamp in ISO 8601 format: YYYY-MM-DDTHH:MM:SSZ. Default: Time.now

Response

Status: 205 Reset Content

Mark notifications as read in a repository

Marking all notifications in a repository as "read" removes them from the default view on GitHub.

PUT /repos/:owner/:repo/notifications

Parameters

Name Type Description
last_read_at string Describes the last point that notifications were checked. Anything updated since this time will not be updated. This is a timestamp in ISO 8601 format: YYYY-MM-DDTHH:MM:SSZ. Default: Time.now

Response

Status: 205 Reset Content

View a single thread

GET /notifications/threads/:id

Response

Status: 200 OK
{
  "id": "1",
  "repository": {
    "id": 1296269,
    "owner": {
      "login": "octocat",
      "id": 1,
      "avatar_url": "https://github.com/images/error/octocat_happy.gif",
      "gravatar_id": "",
      "url": "https://api.github.com/users/octocat",
      "html_url": "https://github.com/octocat",
      "followers_url": "https://api.github.com/users/octocat/followers",
      "following_url": "https://api.github.com/users/octocat/following{/other_user}",
      "gists_url": "https://api.github.com/users/octocat/gists{/gist_id}",
      "starred_url": "https://api.github.com/users/octocat/starred{/owner}{/repo}",
      "subscriptions_url": "https://api.github.com/users/octocat/subscriptions",
      "organizations_url": "https://api.github.com/users/octocat/orgs",
      "repos_url": "https://api.github.com/users/octocat/repos",
      "events_url": "https://api.github.com/users/octocat/events{/privacy}",
      "received_events_url": "https://api.github.com/users/octocat/received_events",
      "type": "User",
      "site_admin": false
    },
    "name": "Hello-World",
    "full_name": "octocat/Hello-World",
    "description": "This your first repo!",
    "private": false,
    "fork": false,
    "url": "https://api.github.com/repos/octocat/Hello-World",
    "html_url": "https://github.com/octocat/Hello-World"
  },
  "subject": {
    "title": "Greetings",
    "url": "https://api.github.com/repos/octokit/octokit.rb/issues/123",
    "latest_comment_url": "https://api.github.com/repos/octokit/octokit.rb/issues/comments/123",
    "type": "Issue"
  },
  "reason": "subscribed",
  "unread": true,
  "updated_at": "2014-11-07T22:01:45Z",
  "last_read_at": "2014-11-07T22:01:45Z",
  "url": "https://api.github.com/notifications/threads/1"
}

Mark a thread as read

PATCH /notifications/threads/:id

Response

Status: 205 Reset Content

Get a Thread Subscription

This checks to see if the current user is subscribed to a thread. You can also get a Repository subscription.

Note that subscriptions are only generated if a user is participating in a conversation--for example, they've replied to the thread, were @mentioned, or manually subscribe to a thread.

GET /notifications/threads/:id/subscription

Response

Status: 200 OK
{
  "subscribed": true,
  "ignored": false,
  "reason": null,
  "created_at": "2012-10-06T21:34:12Z",
  "url": "https://api.github.com/notifications/threads/1/subscription",
  "thread_url": "https://api.github.com/notifications/threads/1"
}

Set a Thread Subscription

This lets you subscribe or unsubscribe from a conversation. Unsubscribing from a conversation mutes all future notifications (until you comment or get @mentioned once more).

PUT /notifications/threads/:id/subscription

Parameters

Name Type Description
subscribed boolean Determines if notifications should be received from this thread
ignored boolean Determines if all notifications should be blocked from this thread

Response

Status: 200 OK
{
  "subscribed": true,
  "ignored": false,
  "reason": null,
  "created_at": "2012-10-06T21:34:12Z",
  "url": "https://api.github.com/notifications/threads/1/subscription",
  "thread_url": "https://api.github.com/notifications/threads/1"
}

Delete a Thread Subscription

DELETE /notifications/threads/:id/subscription

Response

Status: 204 No Content
tmp/developer.github.com/v3/activity/starring/index.html Starring | GitHub Developer Guide

Starring

Repository Starring is a feature that lets users bookmark repositories. Stars are shown next to repositories to show an approximate level of interest. Stars have no effect on notifications or the activity feed. For that, see Repository Watching.

Starring vs. Watching

In August 2012, we changed the way watching works on GitHub. Many API client applications may be using the original "watcher" endpoints for accessing this data. You can now start using the "star" endpoints instead (described below). Check out the Watcher API Change post for more details.

List Stargazers

GET /repos/:owner/:repo/stargazers

Response

Status: 200 OK
Link: <https://api.github.com/resource?page=2>; rel="next",
      <https://api.github.com/resource?page=5>; rel="last"
[
  {
    "login": "octocat",
    "id": 1,
    "avatar_url": "https://github.com/images/error/octocat_happy.gif",
    "gravatar_id": "",
    "url": "https://api.github.com/users/octocat",
    "html_url": "https://github.com/octocat",
    "followers_url": "https://api.github.com/users/octocat/followers",
    "following_url": "https://api.github.com/users/octocat/following{/other_user}",
    "gists_url": "https://api.github.com/users/octocat/gists{/gist_id}",
    "starred_url": "https://api.github.com/users/octocat/starred{/owner}{/repo}",
    "subscriptions_url": "https://api.github.com/users/octocat/subscriptions",
    "organizations_url": "https://api.github.com/users/octocat/orgs",
    "repos_url": "https://api.github.com/users/octocat/repos",
    "events_url": "https://api.github.com/users/octocat/events{/privacy}",
    "received_events_url": "https://api.github.com/users/octocat/received_events",
    "type": "User",
    "site_admin": false
  }
]

Alternative response with star creation timestamps

You can also find out when stars were created by passing the following custom media type via the Accept header:

Accept: application/vnd.github.v3.star+json
Status: 200 OK
Link: <https://api.github.com/resource?page=2>; rel="next",
      <https://api.github.com/resource?page=5>; rel="last"
[
  {
    "starred_at": "2011-01-16T19:06:43Z",
    "user": {
      "login": "octocat",
      "id": 1,
      "avatar_url": "https://github.com/images/error/octocat_happy.gif",
      "gravatar_id": "",
      "url": "https://api.github.com/users/octocat",
      "html_url": "https://github.com/octocat",
      "followers_url": "https://api.github.com/users/octocat/followers",
      "following_url": "https://api.github.com/users/octocat/following{/other_user}",
      "gists_url": "https://api.github.com/users/octocat/gists{/gist_id}",
      "starred_url": "https://api.github.com/users/octocat/starred{/owner}{/repo}",
      "subscriptions_url": "https://api.github.com/users/octocat/subscriptions",
      "organizations_url": "https://api.github.com/users/octocat/orgs",
      "repos_url": "https://api.github.com/users/octocat/repos",
      "events_url": "https://api.github.com/users/octocat/events{/privacy}",
      "received_events_url": "https://api.github.com/users/octocat/received_events",
      "type": "User",
      "site_admin": false
    }
  }
]

List repositories being starred

List repositories being starred by a user.

GET /users/:username/starred

List repositories being starred by the authenticated user.

GET /user/starred

Parameters

Name Type Description
sort string One of created (when the repository was starred) or updated (when it was last pushed to). Default: created
direction string One of asc (ascending) or desc (descending). Default: desc

Response

Status: 200 OK
Link: <https://api.github.com/resource?page=2>; rel="next",
      <https://api.github.com/resource?page=5>; rel="last"
[
  {
    "id": 1296269,
    "owner": {
      "login": "octocat",
      "id": 1,
      "avatar_url": "https://github.com/images/error/octocat_happy.gif",
      "gravatar_id": "",
      "url": "https://api.github.com/users/octocat",
      "html_url": "https://github.com/octocat",
      "followers_url": "https://api.github.com/users/octocat/followers",
      "following_url": "https://api.github.com/users/octocat/following{/other_user}",
      "gists_url": "https://api.github.com/users/octocat/gists{/gist_id}",
      "starred_url": "https://api.github.com/users/octocat/starred{/owner}{/repo}",
      "subscriptions_url": "https://api.github.com/users/octocat/subscriptions",
      "organizations_url": "https://api.github.com/users/octocat/orgs",
      "repos_url": "https://api.github.com/users/octocat/repos",
      "events_url": "https://api.github.com/users/octocat/events{/privacy}",
      "received_events_url": "https://api.github.com/users/octocat/received_events",
      "type": "User",
      "site_admin": false
    },
    "name": "Hello-World",
    "full_name": "octocat/Hello-World",
    "description": "This your first repo!",
    "private": false,
    "fork": false,
    "url": "https://api.github.com/repos/octocat/Hello-World",
    "html_url": "https://github.com/octocat/Hello-World",
    "archive_url": "http://api.github.com/repos/octocat/Hello-World/{archive_format}{/ref}",
    "assignees_url": "http://api.github.com/repos/octocat/Hello-World/assignees{/user}",
    "blobs_url": "http://api.github.com/repos/octocat/Hello-World/git/blobs{/sha}",
    "branches_url": "http://api.github.com/repos/octocat/Hello-World/branches{/branch}",
    "clone_url": "https://github.com/octocat/Hello-World.git",
    "collaborators_url": "http://api.github.com/repos/octocat/Hello-World/collaborators{/collaborator}",
    "comments_url": "http://api.github.com/repos/octocat/Hello-World/comments{/number}",
    "commits_url": "http://api.github.com/repos/octocat/Hello-World/commits{/sha}",
    "compare_url": "http://api.github.com/repos/octocat/Hello-World/compare/{base}...{head}",
    "contents_url": "http://api.github.com/repos/octocat/Hello-World/contents/{+path}",
    "contributors_url": "http://api.github.com/repos/octocat/Hello-World/contributors",
    "deployments_url": "http://api.github.com/repos/octocat/Hello-World/deployments",
    "downloads_url": "http://api.github.com/repos/octocat/Hello-World/downloads",
    "events_url": "http://api.github.com/repos/octocat/Hello-World/events",
    "forks_url": "http://api.github.com/repos/octocat/Hello-World/forks",
    "git_commits_url": "http://api.github.com/repos/octocat/Hello-World/git/commits{/sha}",
    "git_refs_url": "http://api.github.com/repos/octocat/Hello-World/git/refs{/sha}",
    "git_tags_url": "http://api.github.com/repos/octocat/Hello-World/git/tags{/sha}",
    "git_url": "git:github.com/octocat/Hello-World.git",
    "hooks_url": "http://api.github.com/repos/octocat/Hello-World/hooks",
    "issue_comment_url": "http://api.github.com/repos/octocat/Hello-World/issues/comments{/number}",
    "issue_events_url": "http://api.github.com/repos/octocat/Hello-World/issues/events{/number}",
    "issues_url": "http://api.github.com/repos/octocat/Hello-World/issues{/number}",
    "keys_url": "http://api.github.com/repos/octocat/Hello-World/keys{/key_id}",
    "labels_url": "http://api.github.com/repos/octocat/Hello-World/labels{/name}",
    "languages_url": "http://api.github.com/repos/octocat/Hello-World/languages",
    "merges_url": "http://api.github.com/repos/octocat/Hello-World/merges",
    "milestones_url": "http://api.github.com/repos/octocat/Hello-World/milestones{/number}",
    "mirror_url": "git:git.example.com/octocat/Hello-World",
    "notifications_url": "http://api.github.com/repos/octocat/Hello-World/notifications{?since,all,participating}",
    "pulls_url": "http://api.github.com/repos/octocat/Hello-World/pulls{/number}",
    "releases_url": "http://api.github.com/repos/octocat/Hello-World/releases{/id}",
    "ssh_url": "git@github.com:octocat/Hello-World.git",
    "stargazers_url": "http://api.github.com/repos/octocat/Hello-World/stargazers",
    "statuses_url": "http://api.github.com/repos/octocat/Hello-World/statuses/{sha}",
    "subscribers_url": "http://api.github.com/repos/octocat/Hello-World/subscribers",
    "subscription_url": "http://api.github.com/repos/octocat/Hello-World/subscription",
    "svn_url": "https://svn.github.com/octocat/Hello-World",
    "tags_url": "http://api.github.com/repos/octocat/Hello-World/tags",
    "teams_url": "http://api.github.com/repos/octocat/Hello-World/teams",
    "trees_url": "http://api.github.com/repos/octocat/Hello-World/git/trees{/sha}",
    "homepage": "https://github.com",
    "language": null,
    "forks_count": 9,
    "stargazers_count": 80,
    "watchers_count": 80,
    "size": 108,
    "default_branch": "master",
    "open_issues_count": 0,
    "topics": [
      "octocat",
      "atom",
      "electron",
      "API"
    ],
    "has_issues": true,
    "has_wiki": true,
    "has_pages": false,
    "has_downloads": true,
    "archived": false,
    "pushed_at": "2011-01-26T19:06:43Z",
    "created_at": "2011-01-26T19:01:12Z",
    "updated_at": "2011-01-26T19:14:43Z",
    "permissions": {
      "admin": false,
      "push": false,
      "pull": true
    },
    "allow_rebase_merge": true,
    "allow_squash_merge": true,
    "allow_merge_commit": true,
    "subscribers_count": 42,
    "network_count": 0
  }
]

Alternative response with star creation timestamps

You can also find out when stars were created by passing the following custom media type via the Accept header:

Accept: application/vnd.github.v3.star+json
Status: 200 OK
Link: <https://api.github.com/resource?page=2>; rel="next",
      <https://api.github.com/resource?page=5>; rel="last"
[
  {
    "starred_at": "2011-01-16T19:06:43Z",
    "repo": {
      "id": 1296269,
      "owner": {
        "login": "octocat",
        "id": 1,
        "avatar_url": "https://github.com/images/error/octocat_happy.gif",
        "gravatar_id": "",
        "url": "https://api.github.com/users/octocat",
        "html_url": "https://github.com/octocat",
        "followers_url": "https://api.github.com/users/octocat/followers",
        "following_url": "https://api.github.com/users/octocat/following{/other_user}",
        "gists_url": "https://api.github.com/users/octocat/gists{/gist_id}",
        "starred_url": "https://api.github.com/users/octocat/starred{/owner}{/repo}",
        "subscriptions_url": "https://api.github.com/users/octocat/subscriptions",
        "organizations_url": "https://api.github.com/users/octocat/orgs",
        "repos_url": "https://api.github.com/users/octocat/repos",
        "events_url": "https://api.github.com/users/octocat/events{/privacy}",
        "received_events_url": "https://api.github.com/users/octocat/received_events",
        "type": "User",
        "site_admin": false
      },
      "name": "Hello-World",
      "full_name": "octocat/Hello-World",
      "description": "This your first repo!",
      "private": false,
      "fork": false,
      "url": "https://api.github.com/repos/octocat/Hello-World",
      "html_url": "https://github.com/octocat/Hello-World",
      "archive_url": "http://api.github.com/repos/octocat/Hello-World/{archive_format}{/ref}",
      "assignees_url": "http://api.github.com/repos/octocat/Hello-World/assignees{/user}",
      "blobs_url": "http://api.github.com/repos/octocat/Hello-World/git/blobs{/sha}",
      "branches_url": "http://api.github.com/repos/octocat/Hello-World/branches{/branch}",
      "clone_url": "https://github.com/octocat/Hello-World.git",
      "collaborators_url": "http://api.github.com/repos/octocat/Hello-World/collaborators{/collaborator}",
      "comments_url": "http://api.github.com/repos/octocat/Hello-World/comments{/number}",
      "commits_url": "http://api.github.com/repos/octocat/Hello-World/commits{/sha}",
      "compare_url": "http://api.github.com/repos/octocat/Hello-World/compare/{base}...{head}",
      "contents_url": "http://api.github.com/repos/octocat/Hello-World/contents/{+path}",
      "contributors_url": "http://api.github.com/repos/octocat/Hello-World/contributors",
      "deployments_url": "http://api.github.com/repos/octocat/Hello-World/deployments",
      "downloads_url": "http://api.github.com/repos/octocat/Hello-World/downloads",
      "events_url": "http://api.github.com/repos/octocat/Hello-World/events",
      "forks_url": "http://api.github.com/repos/octocat/Hello-World/forks",
      "git_commits_url": "http://api.github.com/repos/octocat/Hello-World/git/commits{/sha}",
      "git_refs_url": "http://api.github.com/repos/octocat/Hello-World/git/refs{/sha}",
      "git_tags_url": "http://api.github.com/repos/octocat/Hello-World/git/tags{/sha}",
      "git_url": "git:github.com/octocat/Hello-World.git",
      "hooks_url": "http://api.github.com/repos/octocat/Hello-World/hooks",
      "issue_comment_url": "http://api.github.com/repos/octocat/Hello-World/issues/comments{/number}",
      "issue_events_url": "http://api.github.com/repos/octocat/Hello-World/issues/events{/number}",
      "issues_url": "http://api.github.com/repos/octocat/Hello-World/issues{/number}",
      "keys_url": "http://api.github.com/repos/octocat/Hello-World/keys{/key_id}",
      "labels_url": "http://api.github.com/repos/octocat/Hello-World/labels{/name}",
      "languages_url": "http://api.github.com/repos/octocat/Hello-World/languages",
      "merges_url": "http://api.github.com/repos/octocat/Hello-World/merges",
      "milestones_url": "http://api.github.com/repos/octocat/Hello-World/milestones{/number}",
      "mirror_url": "git:git.example.com/octocat/Hello-World",
      "notifications_url": "http://api.github.com/repos/octocat/Hello-World/notifications{?since,all,participating}",
      "pulls_url": "http://api.github.com/repos/octocat/Hello-World/pulls{/number}",
      "releases_url": "http://api.github.com/repos/octocat/Hello-World/releases{/id}",
      "ssh_url": "git@github.com:octocat/Hello-World.git",
      "stargazers_url": "http://api.github.com/repos/octocat/Hello-World/stargazers",
      "statuses_url": "http://api.github.com/repos/octocat/Hello-World/statuses/{sha}",
      "subscribers_url": "http://api.github.com/repos/octocat/Hello-World/subscribers",
      "subscription_url": "http://api.github.com/repos/octocat/Hello-World/subscription",
      "svn_url": "https://svn.github.com/octocat/Hello-World",
      "tags_url": "http://api.github.com/repos/octocat/Hello-World/tags",
      "teams_url": "http://api.github.com/repos/octocat/Hello-World/teams",
      "trees_url": "http://api.github.com/repos/octocat/Hello-World/git/trees{/sha}",
      "homepage": "https://github.com",
      "language": null,
      "forks_count": 9,
      "stargazers_count": 80,
      "watchers_count": 80,
      "size": 108,
      "default_branch": "master",
      "open_issues_count": 0,
      "topics": [
        "octocat",
        "atom",
        "electron",
        "API"
      ],
      "has_issues": true,
      "has_wiki": true,
      "has_pages": false,
      "has_downloads": true,
      "archived": false,
      "pushed_at": "2011-01-26T19:06:43Z",
      "created_at": "2011-01-26T19:01:12Z",
      "updated_at": "2011-01-26T19:14:43Z",
      "permissions": {
        "admin": false,
        "push": false,
        "pull": true
      },
      "allow_rebase_merge": true,
      "allow_squash_merge": true,
      "allow_merge_commit": true,
      "subscribers_count": 42,
      "network_count": 0
    }
  }
]

Check if you are starring a repository

Requires for the user to be authenticated.

GET /user/starred/:owner/:repo

Response if this repository is starred by you

Status: 204 No Content

Response if this repository is not starred by you

Status: 404 Not Found

Star a repository

Requires for the user to be authenticated.

PUT /user/starred/:owner/:repo

Note that you'll need to set Content-Length to zero when calling out to this endpoint. For more information, see "HTTP verbs."

Response

Status: 204 No Content

Unstar a repository

Requires for the user to be authenticated.

DELETE /user/starred/:owner/:repo

Response

Status: 204 No Content
tmp/developer.github.com/v3/activity/watching/index.html Watching | GitHub Developer Guide

Watching

Watching a Repository registers the user to receive notifications on new discussions, as well as events in the user's activity feed. See Repository Starring for simple repository bookmarks.

Watching vs. Starring

In August 2012, we changed the way watching works on GitHub. At the time of that change, many API clients were already using the existing "watcher" endpoints to access starring data. To avoid breaking those applications, the legacy "watcher" endpoints continue to provide starring data.

To provide access to watching data, the v3 Watcher API uses the "subscription" endpoints described below. Check out the Watcher API Change post for more details.

List watchers

GET /repos/:owner/:repo/subscribers

Response

Status: 200 OK
Link: <https://api.github.com/resource?page=2>; rel="next",
      <https://api.github.com/resource?page=5>; rel="last"
[
  {
    "login": "octocat",
    "id": 1,
    "avatar_url": "https://github.com/images/error/octocat_happy.gif",
    "gravatar_id": "",
    "url": "https://api.github.com/users/octocat",
    "html_url": "https://github.com/octocat",
    "followers_url": "https://api.github.com/users/octocat/followers",
    "following_url": "https://api.github.com/users/octocat/following{/other_user}",
    "gists_url": "https://api.github.com/users/octocat/gists{/gist_id}",
    "starred_url": "https://api.github.com/users/octocat/starred{/owner}{/repo}",
    "subscriptions_url": "https://api.github.com/users/octocat/subscriptions",
    "organizations_url": "https://api.github.com/users/octocat/orgs",
    "repos_url": "https://api.github.com/users/octocat/repos",
    "events_url": "https://api.github.com/users/octocat/events{/privacy}",
    "received_events_url": "https://api.github.com/users/octocat/received_events",
    "type": "User",
    "site_admin": false
  }
]

List repositories being watched

List repositories being watched by a user.

GET /users/:username/subscriptions

List repositories being watched by the authenticated user.

GET /user/subscriptions

Response

Status: 200 OK
Link: <https://api.github.com/resource?page=2>; rel="next",
      <https://api.github.com/resource?page=5>; rel="last"
[
  {
    "id": 1296269,
    "owner": {
      "login": "octocat",
      "id": 1,
      "avatar_url": "https://github.com/images/error/octocat_happy.gif",
      "gravatar_id": "",
      "url": "https://api.github.com/users/octocat",
      "html_url": "https://github.com/octocat",
      "followers_url": "https://api.github.com/users/octocat/followers",
      "following_url": "https://api.github.com/users/octocat/following{/other_user}",
      "gists_url": "https://api.github.com/users/octocat/gists{/gist_id}",
      "starred_url": "https://api.github.com/users/octocat/starred{/owner}{/repo}",
      "subscriptions_url": "https://api.github.com/users/octocat/subscriptions",
      "organizations_url": "https://api.github.com/users/octocat/orgs",
      "repos_url": "https://api.github.com/users/octocat/repos",
      "events_url": "https://api.github.com/users/octocat/events{/privacy}",
      "received_events_url": "https://api.github.com/users/octocat/received_events",
      "type": "User",
      "site_admin": false
    },
    "name": "Hello-World",
    "full_name": "octocat/Hello-World",
    "description": "This your first repo!",
    "private": false,
    "fork": false,
    "url": "https://api.github.com/repos/octocat/Hello-World",
    "html_url": "https://github.com/octocat/Hello-World",
    "archive_url": "http://api.github.com/repos/octocat/Hello-World/{archive_format}{/ref}",
    "assignees_url": "http://api.github.com/repos/octocat/Hello-World/assignees{/user}",
    "blobs_url": "http://api.github.com/repos/octocat/Hello-World/git/blobs{/sha}",
    "branches_url": "http://api.github.com/repos/octocat/Hello-World/branches{/branch}",
    "clone_url": "https://github.com/octocat/Hello-World.git",
    "collaborators_url": "http://api.github.com/repos/octocat/Hello-World/collaborators{/collaborator}",
    "comments_url": "http://api.github.com/repos/octocat/Hello-World/comments{/number}",
    "commits_url": "http://api.github.com/repos/octocat/Hello-World/commits{/sha}",
    "compare_url": "http://api.github.com/repos/octocat/Hello-World/compare/{base}...{head}",
    "contents_url": "http://api.github.com/repos/octocat/Hello-World/contents/{+path}",
    "contributors_url": "http://api.github.com/repos/octocat/Hello-World/contributors",
    "deployments_url": "http://api.github.com/repos/octocat/Hello-World/deployments",
    "downloads_url": "http://api.github.com/repos/octocat/Hello-World/downloads",
    "events_url": "http://api.github.com/repos/octocat/Hello-World/events",
    "forks_url": "http://api.github.com/repos/octocat/Hello-World/forks",
    "git_commits_url": "http://api.github.com/repos/octocat/Hello-World/git/commits{/sha}",
    "git_refs_url": "http://api.github.com/repos/octocat/Hello-World/git/refs{/sha}",
    "git_tags_url": "http://api.github.com/repos/octocat/Hello-World/git/tags{/sha}",
    "git_url": "git:github.com/octocat/Hello-World.git",
    "hooks_url": "http://api.github.com/repos/octocat/Hello-World/hooks",
    "issue_comment_url": "http://api.github.com/repos/octocat/Hello-World/issues/comments{/number}",
    "issue_events_url": "http://api.github.com/repos/octocat/Hello-World/issues/events{/number}",
    "issues_url": "http://api.github.com/repos/octocat/Hello-World/issues{/number}",
    "keys_url": "http://api.github.com/repos/octocat/Hello-World/keys{/key_id}",
    "labels_url": "http://api.github.com/repos/octocat/Hello-World/labels{/name}",
    "languages_url": "http://api.github.com/repos/octocat/Hello-World/languages",
    "merges_url": "http://api.github.com/repos/octocat/Hello-World/merges",
    "milestones_url": "http://api.github.com/repos/octocat/Hello-World/milestones{/number}",
    "mirror_url": "git:git.example.com/octocat/Hello-World",
    "notifications_url": "http://api.github.com/repos/octocat/Hello-World/notifications{?since,all,participating}",
    "pulls_url": "http://api.github.com/repos/octocat/Hello-World/pulls{/number}",
    "releases_url": "http://api.github.com/repos/octocat/Hello-World/releases{/id}",
    "ssh_url": "git@github.com:octocat/Hello-World.git",
    "stargazers_url": "http://api.github.com/repos/octocat/Hello-World/stargazers",
    "statuses_url": "http://api.github.com/repos/octocat/Hello-World/statuses/{sha}",
    "subscribers_url": "http://api.github.com/repos/octocat/Hello-World/subscribers",
    "subscription_url": "http://api.github.com/repos/octocat/Hello-World/subscription",
    "svn_url": "https://svn.github.com/octocat/Hello-World",
    "tags_url": "http://api.github.com/repos/octocat/Hello-World/tags",
    "teams_url": "http://api.github.com/repos/octocat/Hello-World/teams",
    "trees_url": "http://api.github.com/repos/octocat/Hello-World/git/trees{/sha}",
    "homepage": "https://github.com",
    "language": null,
    "forks_count": 9,
    "stargazers_count": 80,
    "watchers_count": 80,
    "size": 108,
    "default_branch": "master",
    "open_issues_count": 0,
    "topics": [
      "octocat",
      "atom",
      "electron",
      "API"
    ],
    "has_issues": true,
    "has_wiki": true,
    "has_pages": false,
    "has_downloads": true,
    "archived": false,
    "pushed_at": "2011-01-26T19:06:43Z",
    "created_at": "2011-01-26T19:01:12Z",
    "updated_at": "2011-01-26T19:14:43Z",
    "permissions": {
      "admin": false,
      "push": false,
      "pull": true
    },
    "allow_rebase_merge": true,
    "allow_squash_merge": true,
    "allow_merge_commit": true,
    "subscribers_count": 42,
    "network_count": 0,
    "license": {
      "key": "mit",
      "name": "MIT License",
      "spdx_id": "MIT",
      "url": "https://api.github.com/licenses/mit",
      "html_url": "http://choosealicense.com/licenses/mit/"
    }
  }
]

Get a Repository Subscription

GET /repos/:owner/:repo/subscription

Response if you are subscribed to the repository

Status: 200 OK
{
  "subscribed": true,
  "ignored": false,
  "reason": null,
  "created_at": "2012-10-06T21:34:12Z",
  "url": "https://api.github.com/repos/octocat/example/subscription",
  "repository_url": "https://api.github.com/repos/octocat/example"
}

Response if you are not subscribed to the repository

Status: 404 Not Found

Set a Repository Subscription

PUT /repos/:owner/:repo/subscription

Parameters

Name Type Description
subscribed boolean Determines if notifications should be received from this repository.
ignored boolean Determines if all notifications should be blocked from this repository.

If you would like to watch a repository, set subscribed to true. If you would like to ignore notifications made within a repository, set ignored to true. If you would like to stop watching a repository, delete the repository's subscription completely.

Response

Status: 200 OK
{
  "subscribed": true,
  "ignored": false,
  "reason": null,
  "created_at": "2012-10-06T21:34:12Z",
  "url": "https://api.github.com/repos/octocat/example/subscription",
  "repository_url": "https://api.github.com/repos/octocat/example"
}

Delete a Repository Subscription

This endpoint should only be used to stop watching a repository. To control whether or not you wish to receive notifications from a repository, set the repository's subscription manually.

DELETE /repos/:owner/:repo/subscription

Response

Status: 204 No Content

Check if you are watching a repository (LEGACY)

Requires for the user to be authenticated.

GET /user/subscriptions/:owner/:repo

Response if this repository is watched by you

Status: 204 No Content

Response if this repository is not watched by you

Status: 404 Not Found

Watch a repository (LEGACY)

Requires the user to be authenticated.

PUT /user/subscriptions/:owner/:repo

Note that you'll need to set Content-Length to zero when calling out to this endpoint. For more information, see "HTTP verbs."

Response

Status: 204 No Content

Stop watching a repository (LEGACY)

Requires for the user to be authenticated.

DELETE /user/subscriptions/:owner/:repo

Response

Status: 204 No Content
tmp/developer.github.com/v3/apps/index.html GitHub Apps | GitHub Developer Guide

GitHub Apps

For information on how to authenticate as a GitHub App, see "Authentication Options for GitHub Apps."

Note: To access the API with your integration, you must provide a custom media type in the Accept Header for your requests.

application/vnd.github.machine-man-preview+json

Get a single GitHub App

Note: The :app_slug is just the URL-friendly name of your GitHub App. You can find this on the settings page for your GitHub App (e.g., https://github.com/settings/apps/:app_slug).

GET /apps/:app_slug

Response

Status: 200 OK
{
  "id": 1,
  "owner": {
    "login": "github",
    "id": 1,
    "url": "https://api.github.com/orgs/github",
    "repos_url": "https://api.github.com/orgs/github/repos",
    "events_url": "https://api.github.com/orgs/github/events",
    "hooks_url": "https://api.github.com/orgs/github/hooks",
    "issues_url": "https://api.github.com/orgs/github/issues",
    "members_url": "https://api.github.com/orgs/github/members{/member}",
    "public_members_url": "https://api.github.com/orgs/github/public_members{/member}",
    "avatar_url": "https://github.com/images/error/octocat_happy.gif",
    "description": "A great organization"
  },
  "name": "Super CI",
  "description": "",
  "external_url": "https://example.com",
  "html_url": "https://github.com/apps/super-ci",
  "created_at": "2017-07-08T16:18:44-04:00",
  "updated_at": "2017-07-08T16:18:44-04:00"
}

Get the authenticated GitHub App

Returns the GitHub App associated with the authentication credentials used.

GET /app

Response

Status: 200 OK
{
  "id": 1,
  "owner": {
    "login": "github",
    "id": 1,
    "url": "https://api.github.com/orgs/github",
    "repos_url": "https://api.github.com/orgs/github/repos",
    "events_url": "https://api.github.com/orgs/github/events",
    "hooks_url": "https://api.github.com/orgs/github/hooks",
    "issues_url": "https://api.github.com/orgs/github/issues",
    "members_url": "https://api.github.com/orgs/github/members{/member}",
    "public_members_url": "https://api.github.com/orgs/github/public_members{/member}",
    "avatar_url": "https://github.com/images/error/octocat_happy.gif",
    "description": "A great organization"
  },
  "name": "Super CI",
  "description": "",
  "external_url": "https://example.com",
  "html_url": "https://github.com/apps/super-ci",
  "created_at": "2017-07-08T16:18:44-04:00",
  "updated_at": "2017-07-08T16:18:44-04:00"
}

Find installations

GET /app/installations

Response

The permissions the installation has are included under the permissions key.

Status: 200 OK
Link: <https://api.github.com/resource?page=2>; rel="next",
      <https://api.github.com/resource?page=5>; rel="last"
[
  {
    "id": 1,
    "account": {
      "login": "github",
      "id": 1,
      "url": "https://api.github.com/orgs/github",
      "repos_url": "https://api.github.com/orgs/github/repos",
      "events_url": "https://api.github.com/orgs/github/events",
      "hooks_url": "https://api.github.com/orgs/github/hooks",
      "issues_url": "https://api.github.com/orgs/github/issues",
      "members_url": "https://api.github.com/orgs/github/members{/member}",
      "public_members_url": "https://api.github.com/orgs/github/public_members{/member}",
      "avatar_url": "https://github.com/images/error/octocat_happy.gif",
      "description": "A great organization"
    },
    "access_tokens_url": "https://api.github.com/installations/1/access_tokens",
    "repositories_url": "https://api.github.com/installation/repositories",
    "html_url": "https://github.com/organizations/github/settings/installations/1",
    "app_id": 1,
    "target_id": 1,
    "target_type": "Organization",
    "permissions": {
      "metadata": "read",
      "contents": "read",
      "issues": "write",
      "single_file": "write"
    },
    "events": [
      "push",
      "pull_request"
    ],
    "single_file_name": "config.yml",
    "repository_selection": "selected"
  }
]

Get a single installation

GET /app/installations/:installation_id

Response

Status: 200 OK
{
  "id": 1,
  "account": {
    "login": "github",
    "id": 1,
    "url": "https://api.github.com/orgs/github",
    "repos_url": "https://api.github.com/orgs/github/repos",
    "events_url": "https://api.github.com/orgs/github/events",
    "hooks_url": "https://api.github.com/orgs/github/hooks",
    "issues_url": "https://api.github.com/orgs/github/issues",
    "members_url": "https://api.github.com/orgs/github/members{/member}",
    "public_members_url": "https://api.github.com/orgs/github/public_members{/member}",
    "avatar_url": "https://github.com/images/error/octocat_happy.gif",
    "description": "A great organization"
  },
  "access_tokens_url": "https://api.github.com/installations/1/access_tokens",
  "repositories_url": "https://api.github.com/installation/repositories",
  "html_url": "https://github.com/organizations/github/settings/installations/1",
  "app_id": 1,
  "target_id": 1,
  "target_type": "Organization",
  "permissions": {
    "metadata": "read",
    "contents": "read",
    "issues": "write",
    "single_file": "write"
  },
  "events": [
    "push",
    "pull_request"
  ],
  "single_file_name": "config.yml",
  "repository_selection": "selected"
}

List installations for user

List installations that are accessible to the authenticated user.

GET /user/installations?access_token=...

Response

The permissions the installation has are included under the permissions key.

Status: 200 OK
Link: <https://api.github.com/resource?page=2>; rel="next",
      <https://api.github.com/resource?page=5>; rel="last"
{
  "total_count": 2,
  "installations": [
    {
      "id": 1,
      "account": {
        "login": "github",
        "id": 1,
        "url": "https://api.github.com/orgs/github",
        "repos_url": "https://api.github.com/orgs/github/repos",
        "events_url": "https://api.github.com/orgs/github/events",
        "hooks_url": "https://api.github.com/orgs/github/hooks",
        "issues_url": "https://api.github.com/orgs/github/issues",
        "members_url": "https://api.github.com/orgs/github/members{/member}",
        "public_members_url": "https://api.github.com/orgs/github/public_members{/member}",
        "avatar_url": "https://github.com/images/error/octocat_happy.gif",
        "description": "A great organization"
      },
      "access_tokens_url": "https://api.github.com/installations/1/access_tokens",
      "repositories_url": "https://api.github.com/installation/repositories",
      "html_url": "https://github.com/organizations/github/settings/installations/1",
      "app_id": 1,
      "target_id": 1,
      "target_type": "Organization",
      "permissions": {
        "metadata": "read",
        "contents": "read",
        "issues": "write",
        "single_file": "write"
      },
      "events": [
        "push",
        "pull_request"
      ],
      "single_file_name": "config.yml"
    },
    {
      "id": 3,
      "account": {
        "login": "octocat",
        "id": 2,
        "avatar_url": "https://github.com/images/error/octocat_happy.gif",
        "gravatar_id": "",
        "url": "https://api.github.com/users/octocat",
        "html_url": "https://github.com/octocat",
        "followers_url": "https://api.github.com/users/octocat/followers",
        "following_url": "https://api.github.com/users/octocat/following{/other_user}",
        "gists_url": "https://api.github.com/users/octocat/gists{/gist_id}",
        "starred_url": "https://api.github.com/users/octocat/starred{/owner}{/repo}",
        "subscriptions_url": "https://api.github.com/users/octocat/subscriptions",
        "organizations_url": "https://api.github.com/users/octocat/orgs",
        "repos_url": "https://api.github.com/users/octocat/repos",
        "events_url": "https://api.github.com/users/octocat/events{/privacy}",
        "received_events_url": "https://api.github.com/users/octocat/received_events",
        "type": "User",
        "site_admin": false
      },
      "access_tokens_url": "https://api.github.com/installations/1/access_tokens",
      "repositories_url": "https://api.github.com/installation/repositories",
      "html_url": "https://github.com/organizations/github/settings/installations/1",
      "app_id": 1,
      "target_id": 1,
      "target_type": "Organization",
      "permissions": {
        "metadata": "read",
        "contents": "read",
        "issues": "write",
        "single_file": "write"
      },
      "events": [
        "push",
        "pull_request"
      ],
      "single_file_name": "config.yml"
    }
  ]
}

Create a new installation token

POST /installations/:installation_id/access_tokens

Response

Status: 201 Created
{
  "token": "v1.1f699f1069f60xxx",
  "expires_at": "2016-07-11T22:14:10Z"
}
tmp/developer.github.com/v3/apps/available-endpoints/index.html GitHub Apps: Available Endpoints | GitHub Developer Guide

Available Endpoints

Note: To access the API with your integration, you must provide a custom media type in the Accept Header for your requests.

application/vnd.github.machine-man-preview+json

The following endpoints are available for use by GitHub Apps. For more information, see "GitHub Apps."

Codes of Conduct

    Issues

      Licenses

        Source Imports

          Outside Collaborators

            Teams

              Members

                Miscellaneous

                  Markdown

                    Pull Requests

                      Rate Limit

                        Project columns

                          Project cards

                            Starring

                              Events

                                Feeds

                                  Watching

                                    Meta

                                      Public Keys

                                        Search

                                          References

                                            Tags

                                              Commits

                                                Trees

                                                  Blobs

                                                    Repositories

                                                      Reactions

                                                        Users

                                                          Reviews

                                                            Review Comments

                                                              Installations

                                                                GitHub Apps

                                                                  Organizations

                                                                    Projects

                                                                      Merging

                                                                        Community Profile

                                                                          Statistics

                                                                            Deployments

                                                                              Forks

                                                                                Releases

                                                                                  Branches

                                                                                    Contents

                                                                                      Statuses

                                                                                        Deploy Keys

                                                                                          Comments

                                                                                            Collaborators

                                                                                              Pages

                                                                                                Overview

                                                                                                  Timeline

                                                                                                    Milestones

                                                                                                      Assignees

                                                                                                        Labels

                                                                                                          tmp/developer.github.com/v3/apps/installations/index.html Installations | GitHub Developer Guide

                                                                                                          Installations

                                                                                                          For information on how to authenticate as an installation, see "Authentication Options for GitHub Apps."

                                                                                                          Note: To access the API with your integration, you must provide a custom media type in the Accept Header for your requests.

                                                                                                          application/vnd.github.machine-man-preview+json

                                                                                                          List repositories

                                                                                                          List repositories that are accessible to the authenticated installation.

                                                                                                          GET /installation/repositories
                                                                                                          

                                                                                                          Response

                                                                                                          Status: 200 OK
                                                                                                          Link: <https://api.github.com/resource?page=2>; rel="next",
                                                                                                                <https://api.github.com/resource?page=5>; rel="last"
                                                                                                          
                                                                                                          {
                                                                                                            "total_count": 1,
                                                                                                            "repositories": [
                                                                                                              {
                                                                                                                "id": 1296269,
                                                                                                                "owner": {
                                                                                                                  "login": "octocat",
                                                                                                                  "id": 1,
                                                                                                                  "avatar_url": "https://github.com/images/error/octocat_happy.gif",
                                                                                                                  "gravatar_id": "",
                                                                                                                  "url": "https://api.github.com/users/octocat",
                                                                                                                  "html_url": "https://github.com/octocat",
                                                                                                                  "followers_url": "https://api.github.com/users/octocat/followers",
                                                                                                                  "following_url": "https://api.github.com/users/octocat/following{/other_user}",
                                                                                                                  "gists_url": "https://api.github.com/users/octocat/gists{/gist_id}",
                                                                                                                  "starred_url": "https://api.github.com/users/octocat/starred{/owner}{/repo}",
                                                                                                                  "subscriptions_url": "https://api.github.com/users/octocat/subscriptions",
                                                                                                                  "organizations_url": "https://api.github.com/users/octocat/orgs",
                                                                                                                  "repos_url": "https://api.github.com/users/octocat/repos",
                                                                                                                  "events_url": "https://api.github.com/users/octocat/events{/privacy}",
                                                                                                                  "received_events_url": "https://api.github.com/users/octocat/received_events",
                                                                                                                  "type": "User",
                                                                                                                  "site_admin": false
                                                                                                                },
                                                                                                                "name": "Hello-World",
                                                                                                                "full_name": "octocat/Hello-World",
                                                                                                                "description": "This your first repo!",
                                                                                                                "private": false,
                                                                                                                "fork": false,
                                                                                                                "url": "https://api.github.com/repos/octocat/Hello-World",
                                                                                                                "html_url": "https://github.com/octocat/Hello-World",
                                                                                                                "archive_url": "http://api.github.com/repos/octocat/Hello-World/{archive_format}{/ref}",
                                                                                                                "assignees_url": "http://api.github.com/repos/octocat/Hello-World/assignees{/user}",
                                                                                                                "blobs_url": "http://api.github.com/repos/octocat/Hello-World/git/blobs{/sha}",
                                                                                                                "branches_url": "http://api.github.com/repos/octocat/Hello-World/branches{/branch}",
                                                                                                                "clone_url": "https://github.com/octocat/Hello-World.git",
                                                                                                                "collaborators_url": "http://api.github.com/repos/octocat/Hello-World/collaborators{/collaborator}",
                                                                                                                "comments_url": "http://api.github.com/repos/octocat/Hello-World/comments{/number}",
                                                                                                                "commits_url": "http://api.github.com/repos/octocat/Hello-World/commits{/sha}",
                                                                                                                "compare_url": "http://api.github.com/repos/octocat/Hello-World/compare/{base}...{head}",
                                                                                                                "contents_url": "http://api.github.com/repos/octocat/Hello-World/contents/{+path}",
                                                                                                                "contributors_url": "http://api.github.com/repos/octocat/Hello-World/contributors",
                                                                                                                "deployments_url": "http://api.github.com/repos/octocat/Hello-World/deployments",
                                                                                                                "downloads_url": "http://api.github.com/repos/octocat/Hello-World/downloads",
                                                                                                                "events_url": "http://api.github.com/repos/octocat/Hello-World/events",
                                                                                                                "forks_url": "http://api.github.com/repos/octocat/Hello-World/forks",
                                                                                                                "git_commits_url": "http://api.github.com/repos/octocat/Hello-World/git/commits{/sha}",
                                                                                                                "git_refs_url": "http://api.github.com/repos/octocat/Hello-World/git/refs{/sha}",
                                                                                                                "git_tags_url": "http://api.github.com/repos/octocat/Hello-World/git/tags{/sha}",
                                                                                                                "git_url": "git:github.com/octocat/Hello-World.git",
                                                                                                                "hooks_url": "http://api.github.com/repos/octocat/Hello-World/hooks",
                                                                                                                "issue_comment_url": "http://api.github.com/repos/octocat/Hello-World/issues/comments{/number}",
                                                                                                                "issue_events_url": "http://api.github.com/repos/octocat/Hello-World/issues/events{/number}",
                                                                                                                "issues_url": "http://api.github.com/repos/octocat/Hello-World/issues{/number}",
                                                                                                                "keys_url": "http://api.github.com/repos/octocat/Hello-World/keys{/key_id}",
                                                                                                                "labels_url": "http://api.github.com/repos/octocat/Hello-World/labels{/name}",
                                                                                                                "languages_url": "http://api.github.com/repos/octocat/Hello-World/languages",
                                                                                                                "merges_url": "http://api.github.com/repos/octocat/Hello-World/merges",
                                                                                                                "milestones_url": "http://api.github.com/repos/octocat/Hello-World/milestones{/number}",
                                                                                                                "mirror_url": "git:git.example.com/octocat/Hello-World",
                                                                                                                "notifications_url": "http://api.github.com/repos/octocat/Hello-World/notifications{?since,all,participating}",
                                                                                                                "pulls_url": "http://api.github.com/repos/octocat/Hello-World/pulls{/number}",
                                                                                                                "releases_url": "http://api.github.com/repos/octocat/Hello-World/releases{/id}",
                                                                                                                "ssh_url": "git@github.com:octocat/Hello-World.git",
                                                                                                                "stargazers_url": "http://api.github.com/repos/octocat/Hello-World/stargazers",
                                                                                                                "statuses_url": "http://api.github.com/repos/octocat/Hello-World/statuses/{sha}",
                                                                                                                "subscribers_url": "http://api.github.com/repos/octocat/Hello-World/subscribers",
                                                                                                                "subscription_url": "http://api.github.com/repos/octocat/Hello-World/subscription",
                                                                                                                "svn_url": "https://svn.github.com/octocat/Hello-World",
                                                                                                                "tags_url": "http://api.github.com/repos/octocat/Hello-World/tags",
                                                                                                                "teams_url": "http://api.github.com/repos/octocat/Hello-World/teams",
                                                                                                                "trees_url": "http://api.github.com/repos/octocat/Hello-World/git/trees{/sha}",
                                                                                                                "homepage": "https://github.com",
                                                                                                                "language": null,
                                                                                                                "forks_count": 9,
                                                                                                                "stargazers_count": 80,
                                                                                                                "watchers_count": 80,
                                                                                                                "size": 108,
                                                                                                                "default_branch": "master",
                                                                                                                "open_issues_count": 0,
                                                                                                                "topics": [
                                                                                                                  "octocat",
                                                                                                                  "atom",
                                                                                                                  "electron",
                                                                                                                  "API"
                                                                                                                ],
                                                                                                                "has_issues": true,
                                                                                                                "has_wiki": true,
                                                                                                                "has_pages": false,
                                                                                                                "has_downloads": true,
                                                                                                                "archived": false,
                                                                                                                "pushed_at": "2011-01-26T19:06:43Z",
                                                                                                                "created_at": "2011-01-26T19:01:12Z",
                                                                                                                "updated_at": "2011-01-26T19:14:43Z",
                                                                                                                "allow_rebase_merge": true,
                                                                                                                "allow_squash_merge": true,
                                                                                                                "allow_merge_commit": true,
                                                                                                                "subscribers_count": 42,
                                                                                                                "network_count": 0
                                                                                                              }
                                                                                                            ]
                                                                                                          }
                                                                                                          

                                                                                                          List repositories accessible to the user for an installation

                                                                                                          List repositories that are accessible to the authenticated user for an installation.

                                                                                                          GET /user/installations/:installation_id/repositories
                                                                                                          

                                                                                                          Response

                                                                                                          The access the user has to each repository is included in the hash under the permissions key.

                                                                                                          Status: 200 OK
                                                                                                          Link: <https://api.github.com/resource?page=2>; rel="next",
                                                                                                                <https://api.github.com/resource?page=5>; rel="last"
                                                                                                          
                                                                                                          {
                                                                                                            "total_count": 1,
                                                                                                            "repositories": [
                                                                                                              {
                                                                                                                "id": 1296269,
                                                                                                                "owner": {
                                                                                                                  "login": "octocat",
                                                                                                                  "id": 1,
                                                                                                                  "avatar_url": "https://github.com/images/error/octocat_happy.gif",
                                                                                                                  "gravatar_id": "",
                                                                                                                  "url": "https://api.github.com/users/octocat",
                                                                                                                  "html_url": "https://github.com/octocat",
                                                                                                                  "followers_url": "https://api.github.com/users/octocat/followers",
                                                                                                                  "following_url": "https://api.github.com/users/octocat/following{/other_user}",
                                                                                                                  "gists_url": "https://api.github.com/users/octocat/gists{/gist_id}",
                                                                                                                  "starred_url": "https://api.github.com/users/octocat/starred{/owner}{/repo}",
                                                                                                                  "subscriptions_url": "https://api.github.com/users/octocat/subscriptions",
                                                                                                                  "organizations_url": "https://api.github.com/users/octocat/orgs",
                                                                                                                  "repos_url": "https://api.github.com/users/octocat/repos",
                                                                                                                  "events_url": "https://api.github.com/users/octocat/events{/privacy}",
                                                                                                                  "received_events_url": "https://api.github.com/users/octocat/received_events",
                                                                                                                  "type": "User",
                                                                                                                  "site_admin": false
                                                                                                                },
                                                                                                                "name": "Hello-World",
                                                                                                                "full_name": "octocat/Hello-World",
                                                                                                                "description": "This your first repo!",
                                                                                                                "private": false,
                                                                                                                "fork": false,
                                                                                                                "url": "https://api.github.com/repos/octocat/Hello-World",
                                                                                                                "html_url": "https://github.com/octocat/Hello-World",
                                                                                                                "archive_url": "http://api.github.com/repos/octocat/Hello-World/{archive_format}{/ref}",
                                                                                                                "assignees_url": "http://api.github.com/repos/octocat/Hello-World/assignees{/user}",
                                                                                                                "blobs_url": "http://api.github.com/repos/octocat/Hello-World/git/blobs{/sha}",
                                                                                                                "branches_url": "http://api.github.com/repos/octocat/Hello-World/branches{/branch}",
                                                                                                                "clone_url": "https://github.com/octocat/Hello-World.git",
                                                                                                                "collaborators_url": "http://api.github.com/repos/octocat/Hello-World/collaborators{/collaborator}",
                                                                                                                "comments_url": "http://api.github.com/repos/octocat/Hello-World/comments{/number}",
                                                                                                                "commits_url": "http://api.github.com/repos/octocat/Hello-World/commits{/sha}",
                                                                                                                "compare_url": "http://api.github.com/repos/octocat/Hello-World/compare/{base}...{head}",
                                                                                                                "contents_url": "http://api.github.com/repos/octocat/Hello-World/contents/{+path}",
                                                                                                                "contributors_url": "http://api.github.com/repos/octocat/Hello-World/contributors",
                                                                                                                "deployments_url": "http://api.github.com/repos/octocat/Hello-World/deployments",
                                                                                                                "downloads_url": "http://api.github.com/repos/octocat/Hello-World/downloads",
                                                                                                                "events_url": "http://api.github.com/repos/octocat/Hello-World/events",
                                                                                                                "forks_url": "http://api.github.com/repos/octocat/Hello-World/forks",
                                                                                                                "git_commits_url": "http://api.github.com/repos/octocat/Hello-World/git/commits{/sha}",
                                                                                                                "git_refs_url": "http://api.github.com/repos/octocat/Hello-World/git/refs{/sha}",
                                                                                                                "git_tags_url": "http://api.github.com/repos/octocat/Hello-World/git/tags{/sha}",
                                                                                                                "git_url": "git:github.com/octocat/Hello-World.git",
                                                                                                                "hooks_url": "http://api.github.com/repos/octocat/Hello-World/hooks",
                                                                                                                "issue_comment_url": "http://api.github.com/repos/octocat/Hello-World/issues/comments{/number}",
                                                                                                                "issue_events_url": "http://api.github.com/repos/octocat/Hello-World/issues/events{/number}",
                                                                                                                "issues_url": "http://api.github.com/repos/octocat/Hello-World/issues{/number}",
                                                                                                                "keys_url": "http://api.github.com/repos/octocat/Hello-World/keys{/key_id}",
                                                                                                                "labels_url": "http://api.github.com/repos/octocat/Hello-World/labels{/name}",
                                                                                                                "languages_url": "http://api.github.com/repos/octocat/Hello-World/languages",
                                                                                                                "merges_url": "http://api.github.com/repos/octocat/Hello-World/merges",
                                                                                                                "milestones_url": "http://api.github.com/repos/octocat/Hello-World/milestones{/number}",
                                                                                                                "mirror_url": "git:git.example.com/octocat/Hello-World",
                                                                                                                "notifications_url": "http://api.github.com/repos/octocat/Hello-World/notifications{?since,all,participating}",
                                                                                                                "pulls_url": "http://api.github.com/repos/octocat/Hello-World/pulls{/number}",
                                                                                                                "releases_url": "http://api.github.com/repos/octocat/Hello-World/releases{/id}",
                                                                                                                "ssh_url": "git@github.com:octocat/Hello-World.git",
                                                                                                                "stargazers_url": "http://api.github.com/repos/octocat/Hello-World/stargazers",
                                                                                                                "statuses_url": "http://api.github.com/repos/octocat/Hello-World/statuses/{sha}",
                                                                                                                "subscribers_url": "http://api.github.com/repos/octocat/Hello-World/subscribers",
                                                                                                                "subscription_url": "http://api.github.com/repos/octocat/Hello-World/subscription",
                                                                                                                "svn_url": "https://svn.github.com/octocat/Hello-World",
                                                                                                                "tags_url": "http://api.github.com/repos/octocat/Hello-World/tags",
                                                                                                                "teams_url": "http://api.github.com/repos/octocat/Hello-World/teams",
                                                                                                                "trees_url": "http://api.github.com/repos/octocat/Hello-World/git/trees{/sha}",
                                                                                                                "homepage": "https://github.com",
                                                                                                                "language": null,
                                                                                                                "forks_count": 9,
                                                                                                                "stargazers_count": 80,
                                                                                                                "watchers_count": 80,
                                                                                                                "size": 108,
                                                                                                                "default_branch": "master",
                                                                                                                "open_issues_count": 0,
                                                                                                                "topics": [
                                                                                                                  "octocat",
                                                                                                                  "atom",
                                                                                                                  "electron",
                                                                                                                  "API"
                                                                                                                ],
                                                                                                                "has_issues": true,
                                                                                                                "has_wiki": true,
                                                                                                                "has_pages": false,
                                                                                                                "has_downloads": true,
                                                                                                                "archived": false,
                                                                                                                "pushed_at": "2011-01-26T19:06:43Z",
                                                                                                                "created_at": "2011-01-26T19:01:12Z",
                                                                                                                "updated_at": "2011-01-26T19:14:43Z",
                                                                                                                "permissions": {
                                                                                                                  "admin": false,
                                                                                                                  "push": false,
                                                                                                                  "pull": true
                                                                                                                },
                                                                                                                "allow_rebase_merge": true,
                                                                                                                "allow_squash_merge": true,
                                                                                                                "allow_merge_commit": true,
                                                                                                                "subscribers_count": 42,
                                                                                                                "network_count": 0
                                                                                                              }
                                                                                                            ]
                                                                                                          }
                                                                                                          

                                                                                                          Add repository to installation

                                                                                                          Add a single repository to an installation.

                                                                                                          PUT /user/installations/:installation_id/repositories/:repository_id
                                                                                                          

                                                                                                          The authenticated user must have admin access to the repository.

                                                                                                          Response

                                                                                                          Status: 204 No Content
                                                                                                          

                                                                                                          Remove repository from installation

                                                                                                          Remove a single repository from an installation.

                                                                                                          DELETE /user/installations/:installation_id/repositories/:repository_id
                                                                                                          

                                                                                                          The authenticated user must have admin access to the repository.

                                                                                                          Response

                                                                                                          Status: 204 No Content
                                                                                                          
                                                                                                          tmp/developer.github.com/v3/apps/marketplace/index.html GitHub Marketplace | GitHub Developer Guide

                                                                                                          GitHub Marketplace

                                                                                                          Note: The The GitHub Marketplace API on GitHub is currently available for developers to preview. To access the API, you must provide a custom media type in the Accept header:

                                                                                                          application/vnd.github.valkyrie-preview+json
                                                                                                          

                                                                                                          Warning: The API may change without advance notice during the preview period. Preview features are not supported for production use. If you experience any issues, contact GitHub support.

                                                                                                          For more information about GitHub Marketplace, see "GitHub Marketplace."

                                                                                                          Note: This preview includes methods for testing with stubbed data. Stubbed data is fake data that's useful for testing your GitHub Apps. Stubbed data is hard-coded and will not change based on actual subscriptions.

                                                                                                          To test with stubbed data, use a stubbed endpoint in place of its production counterpart. This allows you to test whether API logic succeeds before listing GitHub Apps on GitHub Marketplace.

                                                                                                          Be sure to replace stubbed endpoints with production endpoints before deploying your GitHub App.

                                                                                                          Endpoints for /marketplace_listing/* and /user/marketplace_purchases are only accessible by OAuth Apps using client_id and secret basic authentication or by GitHub Apps using a JWT.

                                                                                                          List all plans for your Marketplace listing

                                                                                                          GET /marketplace_listing/plans
                                                                                                          

                                                                                                          Stubbed endpoint

                                                                                                          GET /marketplace_listing/stubbed/plans
                                                                                                          

                                                                                                          Response

                                                                                                          Status: 200 OK
                                                                                                          Link: <https://api.github.com/resource?page=2>; rel="next",
                                                                                                                <https://api.github.com/resource?page=5>; rel="last"
                                                                                                          
                                                                                                          [
                                                                                                            {
                                                                                                              "url": "https://api.github.com/marketplace_listing/plans/9",
                                                                                                              "accounts_url": "https://api.github.com/marketplace_listing/plans/9/accounts",
                                                                                                              "id": 9,
                                                                                                              "name": "Pro",
                                                                                                              "description": "A professional-grade CI solution",
                                                                                                              "monthly_price_in_cents": 1099,
                                                                                                              "yearly_price_in_cents": 11870,
                                                                                                              "price_model": "flat-rate",
                                                                                                              "has_free_trial": true,
                                                                                                              "unit_name": null,
                                                                                                              "bullets": [
                                                                                                                "This is the first bullet of the plan",
                                                                                                                "This is the second bullet of the plan"
                                                                                                              ]
                                                                                                            }
                                                                                                          ]
                                                                                                          

                                                                                                          List all GitHub accounts (user or organization) on a specific plan

                                                                                                          GET /marketplace_listing/plans/:id/accounts
                                                                                                          

                                                                                                          Stubbed endpoint

                                                                                                          GET /marketplace_listing/stubbed/plans/:id/accounts
                                                                                                          

                                                                                                          Response

                                                                                                          Status: 200 OK
                                                                                                          Link: <https://api.github.com/resource?page=2>; rel="next",
                                                                                                                <https://api.github.com/resource?page=5>; rel="last"
                                                                                                          
                                                                                                          [
                                                                                                            {
                                                                                                              "url": "https://api.github.com/orgs/github",
                                                                                                              "type": "Organization",
                                                                                                              "id": 4,
                                                                                                              "login": "github",
                                                                                                              "email": null,
                                                                                                              "organization_billing_email": "billing@github.com",
                                                                                                              "marketplace_purchase": {
                                                                                                                "billing_cycle": "monthly",
                                                                                                                "next_billing_date": "2017-11-11T00:00:00Z",
                                                                                                                "unit_count": null,
                                                                                                                "on_free_trial": true,
                                                                                                                "free_trial_ends_on": "2017-11-11T00:00:00Z",
                                                                                                                "plan": {
                                                                                                                  "url": "https://api.github.com/marketplace_listing/plans/9",
                                                                                                                  "accounts_url": "https://api.github.com/marketplace_listing/plans/9/accounts",
                                                                                                                  "id": 9,
                                                                                                                  "name": "Pro",
                                                                                                                  "description": "A professional-grade CI solution",
                                                                                                                  "monthly_price_in_cents": 1099,
                                                                                                                  "yearly_price_in_cents": 11870,
                                                                                                                  "price_model": "flat-rate",
                                                                                                                  "has_free_trial": true,
                                                                                                                  "unit_name": null,
                                                                                                                  "bullets": [
                                                                                                                    "This is the first bullet of the plan",
                                                                                                                    "This is the second bullet of the plan"
                                                                                                                  ]
                                                                                                                }
                                                                                                              }
                                                                                                            }
                                                                                                          ]
                                                                                                          

                                                                                                          Check if a GitHub account is associated with any Marketplace listing

                                                                                                          GET /marketplace_listing/accounts/:id
                                                                                                          

                                                                                                          Stubbed endpoint

                                                                                                          GET /marketplace_listing/stubbed/accounts/:id
                                                                                                          

                                                                                                          Response

                                                                                                          Status: 200 OK
                                                                                                          Link: <https://api.github.com/resource?page=2>; rel="next",
                                                                                                                <https://api.github.com/resource?page=5>; rel="last"
                                                                                                          
                                                                                                          [
                                                                                                            {
                                                                                                              "url": "https://api.github.com/orgs/github",
                                                                                                              "type": "Organization",
                                                                                                              "id": 4,
                                                                                                              "login": "github",
                                                                                                              "email": null,
                                                                                                              "organization_billing_email": "billing@github.com",
                                                                                                              "marketplace_purchase": {
                                                                                                                "billing_cycle": "monthly",
                                                                                                                "next_billing_date": "2017-11-11T00:00:00Z",
                                                                                                                "unit_count": null,
                                                                                                                "on_free_trial": true,
                                                                                                                "free_trial_ends_on": "2017-11-11T00:00:00Z",
                                                                                                                "plan": {
                                                                                                                  "url": "https://api.github.com/marketplace_listing/plans/9",
                                                                                                                  "accounts_url": "https://api.github.com/marketplace_listing/plans/9/accounts",
                                                                                                                  "id": 9,
                                                                                                                  "name": "Pro",
                                                                                                                  "description": "A professional-grade CI solution",
                                                                                                                  "monthly_price_in_cents": 1099,
                                                                                                                  "yearly_price_in_cents": 11870,
                                                                                                                  "price_model": "flat-rate",
                                                                                                                  "has_free_trial": true,
                                                                                                                  "unit_name": null,
                                                                                                                  "bullets": [
                                                                                                                    "This is the first bullet of the plan",
                                                                                                                    "This is the second bullet of the plan"
                                                                                                                  ]
                                                                                                                }
                                                                                                              }
                                                                                                            }
                                                                                                          ]
                                                                                                          

                                                                                                          Get a user's Marketplace purchases

                                                                                                          GET /user/marketplace_purchases
                                                                                                          

                                                                                                          Note: This call must be authenticated with a user's OAuth token.

                                                                                                          Stubbed endpoint

                                                                                                          GET /user/marketplace_purchases/stubbed
                                                                                                          

                                                                                                          Response

                                                                                                          Status: 200 OK
                                                                                                          Link: <https://api.github.com/resource?page=2>; rel="next",
                                                                                                                <https://api.github.com/resource?page=5>; rel="last"
                                                                                                          
                                                                                                          [
                                                                                                            {
                                                                                                              "billing_cycle": "monthly",
                                                                                                              "next_billing_date": "2017-11-11T00:00:00Z",
                                                                                                              "unit_count": null,
                                                                                                              "on_free_trial": true,
                                                                                                              "free_trial_ends_on": "2017-11-11T00:00:00Z",
                                                                                                              "account": {
                                                                                                                "login": "github",
                                                                                                                "id": 4,
                                                                                                                "url": "https://api.github.com/orgs/github",
                                                                                                                "email": null,
                                                                                                                "organization_billing_email": "billing@github.com",
                                                                                                                "type": "Organization"
                                                                                                              },
                                                                                                              "plan": {
                                                                                                                "url": "https://api.github.com/marketplace_listing/plans/9",
                                                                                                                "accounts_url": "https://api.github.com/marketplace_listing/plans/9/accounts",
                                                                                                                "id": 9,
                                                                                                                "name": "Pro",
                                                                                                                "description": "A professional-grade CI solution",
                                                                                                                "monthly_price_in_cents": 1099,
                                                                                                                "yearly_price_in_cents": 11870,
                                                                                                                "price_model": "flat-rate",
                                                                                                                "has_free_trial": true,
                                                                                                                "unit_name": null,
                                                                                                                "bullets": [
                                                                                                                  "This is the first bullet of the plan",
                                                                                                                  "This is the second bullet of the plan"
                                                                                                                ]
                                                                                                              }
                                                                                                            }
                                                                                                          ]
                                                                                                          
                                                                                                          tmp/developer.github.com/v3/apps/permissions/index.html GitHub App Permissions | GitHub Developer Guide

                                                                                                          GitHub App Permissions

                                                                                                          Note: To access the API with your integration, you must provide a custom media type in the Accept Header for your requests.

                                                                                                          application/vnd.github.machine-man-preview+json

                                                                                                          GitHub Apps are created with a set of permissions. These define what resources the GitHub App can access via the API. For more information, see "Permissions for GitHub Apps."

                                                                                                          Metadata permissions

                                                                                                          These permissions are enabled for every app. These permissions are a collection of read only endpoints for accessing metadata for various resources that do not leak sensitive private repository information.

                                                                                                          Comments

                                                                                                          Events

                                                                                                          Git

                                                                                                          Keys

                                                                                                          Members

                                                                                                          Permission on "administration"

                                                                                                          Branches

                                                                                                          Collaborators

                                                                                                          Invitations

                                                                                                          Keys

                                                                                                          Teams

                                                                                                          Traffic

                                                                                                          Permission on "contents"

                                                                                                          Branches

                                                                                                          Comments

                                                                                                          Git

                                                                                                          Import

                                                                                                          Releases

                                                                                                          Permission on "deployments"

                                                                                                          Permission on "issues"

                                                                                                          Issues and pull requests are closely related. If your GitHub App has permissions on issues but not on pull requests, these endpoints will be limited to issues. Endpoints that return both issues and pull requests will be filtered. Endpoints that allow operations on both issues and pull requests will be restricted to issues.

                                                                                                          Assignees

                                                                                                          Comments

                                                                                                          Events

                                                                                                          Labels

                                                                                                          Milestones

                                                                                                          Reactions

                                                                                                          Permission on "members"

                                                                                                          Invitations

                                                                                                          Members

                                                                                                          Teams

                                                                                                          Permission on "organization projects"

                                                                                                          Permission on "pages"

                                                                                                          Permission on "pull requests"

                                                                                                          Issues and pull requests are closely related. If your GitHub App has permissions on pull requests but not on issues, these endpoints will be limited to pull requests. Endpoints that return both pull requests and issues will be filtered. Endpoints that allow operations on both pull requests and issues will be restricted to pull requests.

                                                                                                          Assignees

                                                                                                          Comments

                                                                                                          Events

                                                                                                          Labels

                                                                                                          Milestones

                                                                                                          Requested_reviewers

                                                                                                          Reviews

                                                                                                          Permission on "repository projects"

                                                                                                          Permission on "single file"

                                                                                                          Permission on "statuses"

                                                                                                          tmp/developer.github.com/v3/auth/index.html Other Authentication Methods | GitHub Developer Guide

                                                                                                          Other Authentication Methods

                                                                                                          While the API provides multiple methods for authentication, we strongly recommend using OAuth for production applications. The other methods provided are intended to be used for scripts or testing (i.e., cases where full OAuth would be overkill). Third party applications that rely on GitHub for authentication should not ask for or collect GitHub credentials. Instead, they should use the OAuth web flow.

                                                                                                          Basic Authentication

                                                                                                          The API supports Basic Authentication as defined in RFC2617 with a few slight differences. The main difference is that the RFC requires unauthenticated requests to be answered with 401 Unauthorized responses. In many places, this would disclose the existence of user data. Instead, the GitHub API responds with 404 Not Found. This may cause problems for HTTP libraries that assume a 401 Unauthorized response. The solution is to manually craft the Authorization header.

                                                                                                          Via Username and Password

                                                                                                          To use Basic Authentication with the GitHub API, simply send the username and password associated with the account.

                                                                                                          For example, if you're accessing the API via cURL, the following command would authenticate you if you replace <username> with your GitHub username. (cURL will prompt you to enter the password.)

                                                                                                          curl -u username https://api.github.com/user
                                                                                                          

                                                                                                          Via OAuth Tokens

                                                                                                          Alternatively, you can use personal access tokens or OAuth tokens instead of your password.

                                                                                                          curl -u username:token https://api.github.com/user
                                                                                                          

                                                                                                          This approach is useful if your tools only support Basic Authentication but you want to take advantage of OAuth access token security features.

                                                                                                          Authenticating for SAML SSO

                                                                                                          Note: Integrations and Oauth applications that generate tokens on behalf of others are automatically whitelisted.

                                                                                                          If you're using the API to access an organization that enforces SAML SSO for authentication, you'll need to create a personal access token (PAT) and whitelist the token for that organization. Visit the URL specified in X-GitHub-SSO to whitelist the token for the organization.

                                                                                                          curl -v -H "Authorization: token TOKEN" https://api.github.com/repos/octodocs-test/test
                                                                                                          
                                                                                                          X-GitHub-SSO: required; url=https://github.com/orgs/octodocs-test/sso?authorization_request=AZSCKtL4U8yX1H3sCQIVnVgmjmon5fWxks5YrqhJgah0b2tlbl9pZM4EuMz4
                                                                                                          {
                                                                                                            "message": "Resource protected by organization SAML enforcement. You must grant your personal token access to this organization.",
                                                                                                            "documentation_url": "https://help.github.com"
                                                                                                          }
                                                                                                          

                                                                                                          When requesting data that could come from multiple organizations (for example, requesting a list of issues created by the user), the X-GitHub-SSO header indicates which organizations require whitelisting:

                                                                                                          curl -v -H "Authorization: token TOKEN" https://api.github.com/user/issues
                                                                                                          
                                                                                                          X-GitHub-SSO: partial-results; organizations=21955855,20582480
                                                                                                          

                                                                                                          The value organizations is a comma-separated list of organization IDs for organizations that require whitelisting.

                                                                                                          Working with two-factor authentication

                                                                                                          For users with two-factor authentication enabled, Basic Authentication requires an extra step. When you attempt to authenticate with Basic Authentication, the server will respond with a 401 and an X-GitHub-OTP: required; :2fa-type header. This indicates that a two-factor authentication code is needed (in addition to the username and password). The :2fa-type in this header indicates whether the account receives its two-factor authentication codes via SMS or via an application.

                                                                                                          In addition to the Basic Authentication credentials, you must send the user's authentication code (i.e., one-time password) in the X-GitHub-OTP header. Because these authentication codes expire quickly, we recommend using the Authorizations API to create an access token and using that token to authenticate via OAuth for most API access.

                                                                                                          Alternately, you can create access tokens from the Personal Access Token settings page.

                                                                                                          tmp/developer.github.com/v3/codes_of_conduct/index.html Codes of Conduct | GitHub Developer Guide

                                                                                                          Codes of Conduct

                                                                                                          The Codes of Conduct API is currently available for developers to preview. During the preview period, the API may change without advance notice.

                                                                                                          To access the API during the preview period, you must provide a custom media type in the Accept header:

                                                                                                            application/vnd.github.scarlet-witch-preview+json
                                                                                                          

                                                                                                          List all codes of conduct

                                                                                                          GET /codes_of_conduct
                                                                                                          

                                                                                                          Response

                                                                                                          Status: 200 OK
                                                                                                          
                                                                                                          [
                                                                                                            {
                                                                                                              "key": "citizen_code_of_conduct",
                                                                                                              "name": "Citizen Code of Conduct",
                                                                                                              "url": "https://api.github.com/codes_of_conduct/citizen_code_of_conduct"
                                                                                                            },
                                                                                                            {
                                                                                                              "key": "contributor_covenant",
                                                                                                              "name": "Contributor Covenant",
                                                                                                              "url": "https://api.github.com/codes_of_conduct/contributor_covenant"
                                                                                                            }
                                                                                                          ]
                                                                                                          

                                                                                                          Get an individual code of conduct

                                                                                                          GET /codes_of_conduct/:key
                                                                                                          

                                                                                                          Response

                                                                                                          Status: 200 OK
                                                                                                          
                                                                                                          {
                                                                                                            "key": "contributor_covenant",
                                                                                                            "name": "Contributor Covenant",
                                                                                                            "url": "https://api.github.com/codes_of_conduct/contributor_covenant",
                                                                                                            "body": "# Contributor Covenant Code of Conduct\n\n## Our Pledge\n\nIn the interest of fostering an open and welcoming environment, we as contributors and maintainers pledge to making participation in our project and our community a harassment-free experience for everyone, regardless of age, body size, disability, ethnicity, gender identity and expression, level of experience, nationality, personal appearance, race, religion, or sexual identity and orientation.\n\n## Our Standards\n\nExamples of behavior that contributes to creating a positive environment include:\n\n* Using welcoming and inclusive language\n* Being respectful of differing viewpoints and experiences\n* Gracefully accepting constructive criticism\n* Focusing on what is best for the community\n* Showing empathy towards other community members\n\nExamples of unacceptable behavior by participants include:\n\n* The use of sexualized language or imagery and unwelcome sexual attention or advances\n* Trolling, insulting/derogatory comments, and personal or political attacks\n* Public or private harassment\n* Publishing others' private information, such as a physical or electronic address, without explicit permission\n* Other conduct which could reasonably be considered inappropriate in a professional setting\n\n## Our Responsibilities\n\nProject maintainers are responsible for clarifying the standards of acceptable behavior and are expected to take appropriate and fair corrective action in response\n                  to any instances of unacceptable behavior.\n\nProject maintainers have the right and responsibility to remove, edit, or reject comments, commits, code, wiki edits, issues, and other contributions that are not aligned to this Code of Conduct, or to ban temporarily or permanently any contributor for other behaviors that they deem inappropriate, threatening, offensive, or harmful.\n\n## Scope\n\nThis Code of Conduct applies both within project spaces and in public spaces when an individual is representing the project or its community. Examples of representing a project or community include using an official project e-mail address,\n                  posting via an official social media account, or acting as an appointed representative at an online or offline event. Representation of a project may be further defined and clarified by project maintainers.\n\n## Enforcement\n\nInstances of abusive, harassing, or otherwise unacceptable behavior may be reported by contacting the project team at [EMAIL]. The project team will review and investigate all complaints, and will respond in a way that it deems appropriate to the circumstances. The project team is obligated to maintain confidentiality with regard to the reporter of an incident. Further details of specific enforcement policies may be posted separately.\n\nProject maintainers who do not follow or enforce the Code of Conduct in good faith may face temporary or permanent repercussions as determined by other members of the project's leadership.\n\n## Attribution\n\nThis Code of Conduct is adapted from the [Contributor Covenant][homepage], version 1.4, available at [http://contributor-covenant.org/version/1/4][version]\n\n[homepage]: http://contributor-covenant.org\n[version]: http://contributor-covenant.org/version/1/4/\n"
                                                                                                          }
                                                                                                          

                                                                                                          Get a repository's code of conduct

                                                                                                          When passed the preview media type, requests to get a repository will also return the repository's code of conduct if it can be detected from the repository's code of conduct file.

                                                                                                          GET /repos/:owner/:repo
                                                                                                          

                                                                                                          Response

                                                                                                          Status: 200 OK
                                                                                                          
                                                                                                          {
                                                                                                            "id": 88760408,
                                                                                                            "name": "cosee",
                                                                                                            "full_name": "LindseyB/cosee",
                                                                                                            "owner": {
                                                                                                              "login": "LindseyB",
                                                                                                              "id": 33750,
                                                                                                              "avatar_url": "https://avatars2.githubusercontent.com/u/33750?v=3",
                                                                                                              "gravatar_id": "",
                                                                                                              "url": "https://api.github.com/users/LindseyB",
                                                                                                              "html_url": "https://github.com/LindseyB",
                                                                                                              "followers_url": "https://api.github.com/users/LindseyB/followers",
                                                                                                              "following_url": "https://api.github.com/users/LindseyB/following{/other_user}",
                                                                                                              "gists_url": "https://api.github.com/users/LindseyB/gists{/gist_id}",
                                                                                                              "starred_url": "https://api.github.com/users/LindseyB/starred{/owner}{/repo}",
                                                                                                              "subscriptions_url": "https://api.github.com/users/LindseyB/subscriptions",
                                                                                                              "organizations_url": "https://api.github.com/users/LindseyB/orgs",
                                                                                                              "repos_url": "https://api.github.com/users/LindseyB/repos",
                                                                                                              "events_url": "https://api.github.com/users/LindseyB/events{/privacy}",
                                                                                                              "received_events_url": "https=>//api.github.com/users/LindseyB/received_events",
                                                                                                              "type": "User",
                                                                                                              "site_admin": true
                                                                                                            },
                                                                                                            "private": false,
                                                                                                            "html_url": "https://github.com/LindseyB/cosee",
                                                                                                            "description": null,
                                                                                                            "fork": false,
                                                                                                            "url": "https://api.github.com/repos/LindseyB/cosee",
                                                                                                            "forks_url": "https://api.github.com/repos/LindseyB/cosee/forks",
                                                                                                            "keys_url": "https://api.github.com/repos/LindseyB/cosee/keys{/key_id}",
                                                                                                            "collaborators_url": "https://api.github.com/repos/LindseyB/cosee/collaborators{/collaborator}",
                                                                                                            "teams_url": "https://api.github.com/repos/LindseyB/cosee/teams",
                                                                                                            "hooks_url": "https://api.github.com/repos/LindseyB/cosee/hooks",
                                                                                                            "issue_events_url": "https://api.github.com/repos/LindseyB/cosee/issues/events{/number}",
                                                                                                            "events_url": "https://api.github.com/repos/LindseyB/cosee/events",
                                                                                                            "assignees_url": "https://api.github.com/repos/LindseyB/cosee/assignees{/user}",
                                                                                                            "branches_url": "https://api.github.com/repos/LindseyB/cosee/branches{/branch}",
                                                                                                            "tags_url": "https://api.github.com/repos/LindseyB/cosee/tags",
                                                                                                            "blobs_url": "https://api.github.com/repos/LindseyB/cosee/git/blobs{/sha}",
                                                                                                            "git_tags_url": "https://api.github.com/repos/LindseyB/cosee/git/tags{/sha}",
                                                                                                            "git_refs_url": "https://api.github.com/repos/LindseyB/cosee/git/refs{/sha}",
                                                                                                            "trees_url": "https://api.github.com/repos/LindseyB/cosee/git/trees{/sha}",
                                                                                                            "statuses_url": "https://api.github.com/repos/LindseyB/cosee/statuses/{sha}",
                                                                                                            "languages_url": "https://api.github.com/repos/LindseyB/cosee/languages",
                                                                                                            "stargazers_url": "https://api.github.com/repos/LindseyB/cosee/stargazers",
                                                                                                            "contributors_url": "https://api.github.com/repos/LindseyB/cosee/contributors",
                                                                                                            "subscribers_url": "https://api.github.com/repos/LindseyB/cosee/subscribers",
                                                                                                            "subscription_url": "https://api.github.com/repos/LindseyB/cosee/subscription",
                                                                                                            "commits_url": "https://api.github.com/repos/LindseyB/cosee/commits{/sha}",
                                                                                                            "git_commits_url": "https://api.github.com/repos/LindseyB/cosee/git/commits{/sha}",
                                                                                                            "comments_url": "https://api.github.com/repos/LindseyB/cosee/comments{/number}",
                                                                                                            "issue_comment_url": "https://api.github.com/repos/LindseyB/cosee/issues/comments{/number}",
                                                                                                            "contents_url": "https://api.github.com/repos/LindseyB/cosee/contents/{+path}",
                                                                                                            "compare_url": "https://api.github.com/repos/LindseyB/cosee/compare/{base}...{head}",
                                                                                                            "merges_url": "https://api.github.com/repos/LindseyB/cosee/merges",
                                                                                                            "archive_url": "https://api.github.com/repos/LindseyB/cosee/{archive_format}{/ref}",
                                                                                                            "downloads_url": "https://api.github.com/repos/LindseyB/cosee/downloads",
                                                                                                            "issues_url": "https://api.github.com/repos/LindseyB/cosee/issues{/number}",
                                                                                                            "pulls_url": "https://api.github.com/repos/LindseyB/cosee/pulls{/number}",
                                                                                                            "milestones_url": "https://api.github.com/repos/LindseyB/cosee/milestones{/number}",
                                                                                                            "notifications_url": "https://api.github.com/repos/LindseyB/cosee/notifications{?since,all,participating}",
                                                                                                            "labels_url": "https://api.github.com/repos/LindseyB/cosee/labels{/name}",
                                                                                                            "releases_url": "https://api.github.com/repos/LindseyB/cosee/releases{/id}",
                                                                                                            "deployments_url": "https://api.github.com/repos/LindseyB/cosee/deployments",
                                                                                                            "created_at": "2017-04-19T15=>23=>26Z",
                                                                                                            "updated_at": "2017-04-19T15=>23=>26Z",
                                                                                                            "pushed_at": "2017-04-19T15=>34=>03Z",
                                                                                                            "git_url": "git://github.com/LindseyB/cosee.git",
                                                                                                            "ssh_url": "git@github.com=>LindseyB/cosee.git",
                                                                                                            "clone_url": "https://github.com/LindseyB/cosee.git",
                                                                                                            "svn_url": "https://github.com/LindseyB/cosee",
                                                                                                            "homepage": null,
                                                                                                            "size": 1,
                                                                                                            "stargazers_count": 0,
                                                                                                            "watchers_count": 0,
                                                                                                            "language": null,
                                                                                                            "has_issues": true,
                                                                                                            "has_projects": true,
                                                                                                            "has_downloads": true,
                                                                                                            "has_wiki": true,
                                                                                                            "has_pages": false,
                                                                                                            "forks_count": 0,
                                                                                                            "mirror_url": null,
                                                                                                            "open_issues_count": 0,
                                                                                                            "forks": 0,
                                                                                                            "open_issues": 0,
                                                                                                            "watchers": 0,
                                                                                                            "default_branch": "master",
                                                                                                            "code_of_conduct": {
                                                                                                              "key": "contributor_covenant",
                                                                                                              "name": "Contributor Covenant",
                                                                                                              "url": "https://github.com/LindseyB/cosee/blob/master/CODE_OF_CONDUCT.md"
                                                                                                            },
                                                                                                            "network_count": 0,
                                                                                                            "subscribers_count": 0
                                                                                                          }
                                                                                                          

                                                                                                          Get the contents of a repository's code of conduct

                                                                                                          This method returns the contents of the repository's code of conduct file, if one is detected.

                                                                                                          GET /repos/:owner/:repo/community/code_of_conduct
                                                                                                          

                                                                                                          Response

                                                                                                          Status: 200 OK
                                                                                                          
                                                                                                          {
                                                                                                            "key": "contributor_covenant",
                                                                                                            "name": "Contributor Covenant",
                                                                                                            "url": "https://github.com/LindseyB/cosee/blob/master/CODE_OF_CONDUCT.md",
                                                                                                            "body": "# Contributor Covenant Code of Conduct\n\n## Our Pledge\n\nIn the interest of fostering an open and welcoming environment, we as contributors and maintainers pledge to making participation in our project and our community a harassment-free experience for everyone, regardless of age, body size, disability, ethnicity, gender identity and expression, level of experience, nationality, personal appearance, race, religion, or sexual identity and orientation.\n\n## Our Standards\n\nExamples of behavior that contributes to creating a positive environment include=>\n\n* Using welcoming and inclusive language\n* Being respectful of differing viewpoints and experiences\n* Gracefully accepting constructive criticism\n* Focusing on what is best for the community\n* Showing empathy towards other community members\n\nExamples of unacceptable behavior by participants include=>\n\n* The use of sexualized language or imagery and unwelcome sexual attention or advances\n* Trolling, insulting/derogatory comments, and personal or political attacks\n* Public or private harassment\n* Publishing others' private information, such as a physical or electronic address, without explicit permission\n* Other conduct which could reasonably be considered inappropriate in a professional setting\n\n## Our Responsibilities\n\nProject maintainers are responsible for clarifying the standards of acceptable behavior and are expected to take appropriate and fair corrective action in response\nto any instances of unacceptable behavior.\n\nProject maintainers have the right and responsibility to remove, edit, or reject comments, commits, code, wiki edits, issues, and other contributions that are not aligned to this Code of Conduct, or to ban temporarily or permanently any contributor for other behaviors that they deem inappropriate, threatening, offensive, or harmful.\n\n## Scope\n\nThis Code of Conduct applies both within project spaces and in public spaces when an individual is representing the project or its community. Examples of representing a project or community include using an official project e-mail address,\nposting via an official social media account, or acting as an appointed representative at an online or offline event. Representation of a project may be further defined and clarified by project maintainers.\n\n## Enforcement\n\nInstances of abusive, harassing, or otherwise unacceptable behavior may be reported by contacting the project team at lindseyb@github.com. The project team will review and investigate all complaints, and will respond in a way that it deems appropriate to the circumstances. The project team is obligated to maintain confidentiality with regard to the reporter of an incident. Further details of specific enforcement policies may be posted separately.\n\nProject maintainers who do not follow or enforce the Code of Conduct in good faith may face temporary or permanent repercussions as determined by other members of the project's leadership.\n\n## Attribution\n\nThis Code of Conduct is adapted from the [Contributor Covenant][homepage], version 1.4, available at [http://contributor-covenant.org/version/1/4][version]\n\n[homepage]: http://contributor-covenant.org\n[version]: http://contributor-covenant.org/version/1/4/\n"
                                                                                                          }
                                                                                                          
                                                                                                          tmp/developer.github.com/v3/emojis/index.html Emojis | GitHub Developer Guide

                                                                                                          Emojis

                                                                                                          Lists all the emojis available to use on GitHub.

                                                                                                          GET /emojis
                                                                                                          

                                                                                                          Response

                                                                                                          Status: 200 OK
                                                                                                          
                                                                                                          {
                                                                                                            "+1": "https://github.global.ssl.fastly.net/images/icons/emoji/+1.png?v5",
                                                                                                            "-1": "https://github.global.ssl.fastly.net/images/icons/emoji/-1.png?v5",
                                                                                                            "100": "https://github.global.ssl.fastly.net/images/icons/emoji/100.png?v5",
                                                                                                            "1234": "https://github.global.ssl.fastly.net/images/icons/emoji/1234.png?v5",
                                                                                                            "8ball": "https://github.global.ssl.fastly.net/images/icons/emoji/8ball.png?v5",
                                                                                                            "a": "https://github.global.ssl.fastly.net/images/icons/emoji/a.png?v5",
                                                                                                            "ab": "https://github.global.ssl.fastly.net/images/icons/emoji/ab.png?v5"
                                                                                                          }
                                                                                                          
                                                                                                          tmp/developer.github.com/v3/enterprise/index.html Enterprise | GitHub Developer Guide

                                                                                                          Enterprise 2.12

                                                                                                          See the Enterprise homepage for information about the supported releases. These Enterprise-specific endpoints are available:

                                                                                                          Endpoint URLs

                                                                                                          REST API endpoints—except Management Console API endpoints—are prefixed with the following URL:

                                                                                                          http(s)://hostname/api/v3/
                                                                                                          

                                                                                                          Management Console API endpoints are only prefixed with a hostname:

                                                                                                          http(s)://hostname/
                                                                                                          

                                                                                                          Authentication

                                                                                                          Your Enterprise installation's API endpoints accept the same authentication methods as the GitHub.com API. You can authenticate yourself with OAuth tokens (which can be created using the Authorizations API) or basic authentication.

                                                                                                          Every Enterprise API endpoint is only accessible to GitHub Enterprise site administrators, with the exception of the Management Console API, which is only accessible via the Management Console password.

                                                                                                          Version information

                                                                                                          The current version of a GitHub Enterprise instance is returned in the response header of every API:

                                                                                                          X-GitHub-Enterprise-Version: 2.12.0

                                                                                                          You can also read the current version by calling the meta endpoint.

                                                                                                          tmp/developer.github.com/v3/enterprise-admin/admin_stats/index.html Admin Stats | GitHub Developer Guide

                                                                                                          Admin Stats

                                                                                                          The Admin Stats API provides a variety of metrics about your installation. It is only available to authenticated site administrators. Normal users will receive a 404 response if they try to access it.

                                                                                                          Prefix all the endpoints for this API with the following URL:

                                                                                                          http(s)://hostname/api/v3
                                                                                                          

                                                                                                          Get statistics

                                                                                                          Request

                                                                                                          GET /enterprise/stats/:type
                                                                                                          

                                                                                                          There are a variety of types to choose from:

                                                                                                          Type Description
                                                                                                          issues The number of open and closed issues.
                                                                                                          hooks The number of active and inactive hooks.
                                                                                                          milestones The number of open and closed milestones.
                                                                                                          orgs The number of organizations, teams, team members, and disabled organizations.
                                                                                                          comments The number of comments on issues, pull requests, commits, and gists.
                                                                                                          pages The number of GitHub Pages sites.
                                                                                                          users The number of suspended and admin users.
                                                                                                          gists The number of private and public gists.
                                                                                                          pulls The number of merged, mergeable, and unmergeable pull requests.
                                                                                                          repos The number of organization-owned repositories, root repositories, forks, pushed commits, and wikis.
                                                                                                          all All of the statistics listed above.

                                                                                                          These statistics are cached and will be updated approximately every 10 minutes.

                                                                                                          Response

                                                                                                          Status: 200 OK
                                                                                                          
                                                                                                          {
                                                                                                            "repos": {
                                                                                                              "total_repos": 212,
                                                                                                              "root_repos": 194,
                                                                                                              "fork_repos": 18,
                                                                                                              "org_repos": 51,
                                                                                                              "total_pushes": 3082,
                                                                                                              "total_wikis": 15
                                                                                                            },
                                                                                                            "hooks": {
                                                                                                              "total_hooks": 27,
                                                                                                              "active_hooks": 23,
                                                                                                              "inactive_hooks": 4
                                                                                                            },
                                                                                                            "pages": {
                                                                                                              "total_pages": 36
                                                                                                            },
                                                                                                            "orgs": {
                                                                                                              "total_orgs": 33,
                                                                                                              "disabled_orgs": 0,
                                                                                                              "total_teams": 60,
                                                                                                              "total_team_members": 314
                                                                                                            },
                                                                                                            "users": {
                                                                                                              "total_users": 254,
                                                                                                              "admin_users": 45,
                                                                                                              "suspended_users": 21
                                                                                                            },
                                                                                                            "pulls": {
                                                                                                              "total_pulls": 86,
                                                                                                              "merged_pulls": 60,
                                                                                                              "mergeable_pulls": 21,
                                                                                                              "unmergeable_pulls": 3
                                                                                                            },
                                                                                                            "issues": {
                                                                                                              "total_issues": 179,
                                                                                                              "open_issues": 83,
                                                                                                              "closed_issues": 96
                                                                                                            },
                                                                                                            "milestones": {
                                                                                                              "total_milestones": 7,
                                                                                                              "open_milestones": 6,
                                                                                                              "closed_milestones": 1
                                                                                                            },
                                                                                                            "gists": {
                                                                                                              "total_gists": 178,
                                                                                                              "private_gists": 151,
                                                                                                              "public_gists": 25
                                                                                                            },
                                                                                                            "comments": {
                                                                                                              "total_commit_comments": 6,
                                                                                                              "total_gist_comments": 28,
                                                                                                              "total_issue_comments": 366,
                                                                                                              "total_pull_request_comments": 30
                                                                                                            }
                                                                                                          }
                                                                                                          
                                                                                                          tmp/developer.github.com/v3/enterprise-admin/global_webhooks/index.html Global Webhooks | GitHub Developer Guide

                                                                                                          Global webhooks

                                                                                                          Note: The Global Webhooks API is currently available for developers to preview. To access the API during the preview period, you must provide a custom media type in the Accept header:

                                                                                                          application/vnd.github.superpro-preview+json
                                                                                                          

                                                                                                          Warning: The API may change without advance notice during the preview period. Preview features are not supported for production use. If you experience any issues, contact GitHub support.

                                                                                                          Global webhooks are installed on a GitHub Enterprise instance. You can use global webhooks to automatically monitor, respond to, or enforce rules for user and organization management on your instance. Global webhooks can subscribe to organization and user event types. This API is only available to authenticated site administrators. Normal users will receive a 404 response if they try to access it. You can also configure global webhooks in the Admin center. For more information, see about global webhooks.

                                                                                                          List global hooks

                                                                                                          Note: The Global Webhooks API is currently available for developers to preview. To access the API during the preview period, you must provide a custom media type in the Accept header:

                                                                                                          application/vnd.github.superpro-preview+json
                                                                                                          

                                                                                                          Warning: The API may change without advance notice during the preview period. Preview features are not supported for production use. If you experience any issues, contact GitHub support.

                                                                                                          GET /admin/hooks
                                                                                                          

                                                                                                          Response

                                                                                                          Status: 200 OK
                                                                                                          Link: <https://api.github.com/resource?page=2>; rel="next",
                                                                                                                <https://api.github.com/resource?page=5>; rel="last"
                                                                                                          
                                                                                                          [
                                                                                                            {
                                                                                                              "type": "Global",
                                                                                                              "id": 1,
                                                                                                              "name": "web",
                                                                                                              "active": true,
                                                                                                              "events": [
                                                                                                                "organization",
                                                                                                                "user"
                                                                                                              ],
                                                                                                              "config": {
                                                                                                                "url": "https://example.com",
                                                                                                                "content_type": "json",
                                                                                                                "insecure_ssl": "0",
                                                                                                                "secret": "********"
                                                                                                              },
                                                                                                              "updated_at": "2017-12-07T00:14:59Z",
                                                                                                              "created_at": "2017-12-07T00:14:59Z",
                                                                                                              "url": "https://api.github.com/admin/hooks/1",
                                                                                                              "ping_url": "https://api.github.com/admin/hooks/1/pings"
                                                                                                            }
                                                                                                          ]
                                                                                                          

                                                                                                          Get single global hook

                                                                                                          Note: The Global Webhooks API is currently available for developers to preview. To access the API during the preview period, you must provide a custom media type in the Accept header:

                                                                                                          application/vnd.github.superpro-preview+json
                                                                                                          

                                                                                                          Warning: The API may change without advance notice during the preview period. Preview features are not supported for production use. If you experience any issues, contact GitHub support.

                                                                                                          GET /admin/hooks/:id
                                                                                                          

                                                                                                          Response

                                                                                                          Status: 200 OK
                                                                                                          
                                                                                                          {
                                                                                                            "type": "Global",
                                                                                                            "id": 1,
                                                                                                            "name": "web",
                                                                                                            "active": true,
                                                                                                            "events": [
                                                                                                              "organization",
                                                                                                              "user"
                                                                                                            ],
                                                                                                            "config": {
                                                                                                              "url": "https://example.com",
                                                                                                              "content_type": "json",
                                                                                                              "insecure_ssl": "0",
                                                                                                              "secret": "********"
                                                                                                            },
                                                                                                            "updated_at": "2017-12-07T00:14:59Z",
                                                                                                            "created_at": "2017-12-07T00:14:59Z",
                                                                                                            "url": "https://api.github.com/admin/hooks/1",
                                                                                                            "ping_url": "https://api.github.com/admin/hooks/1/pings"
                                                                                                          }
                                                                                                          

                                                                                                          Create a global hook

                                                                                                          Note: The Global Webhooks API is currently available for developers to preview. To access the API during the preview period, you must provide a custom media type in the Accept header:

                                                                                                          application/vnd.github.superpro-preview+json
                                                                                                          

                                                                                                          Warning: The API may change without advance notice during the preview period. Preview features are not supported for production use. If you experience any issues, contact GitHub support.

                                                                                                          POST /admin/hooks
                                                                                                          

                                                                                                          Parameters

                                                                                                          Name Type Description
                                                                                                          name string Required. Must be passed as "web".
                                                                                                          config object Required. Key/value pairs to provide settings for this webhook. These are defined below.
                                                                                                          events array The events that trigger this webhook. A global webhook can be triggered by user and organization events. Default: user and organization.
                                                                                                          active boolean Determines if notifications are sent when the webhook is triggered. Set to true to send notifications. Default: true.

                                                                                                          The config object can accept the following keys:

                                                                                                          Name Type Description
                                                                                                          url string Required The URL to which the payloads will be delivered.
                                                                                                          content_type string The media type used to serialize the payloads. Supported values include json and form. The default is form.
                                                                                                          secret string If provided, the secret will be used as the key to generate the HMAC hex digest value in the X-Hub-Signature header.
                                                                                                          insecure_ssl string Determines whether the SSL certificate of the host for url will be verified when delivering payloads. Supported values include 0 (verification is performed) and 1 (verification is not performed). The default is 0. We strongly recommend not setting this to 1 as you are subject to man-in-the-middle and other attacks.

                                                                                                          Example

                                                                                                          {
                                                                                                            "name": "web",
                                                                                                            "events": [
                                                                                                              "organization",
                                                                                                              "user"
                                                                                                            ],
                                                                                                            "config": {
                                                                                                              "url": "https://example.com/webhook",
                                                                                                              "content_type": "json",
                                                                                                              "secret": "secret"
                                                                                                            }
                                                                                                          }
                                                                                                          

                                                                                                          Response

                                                                                                          Status: 201 Created
                                                                                                          Location:
                                                                                                          
                                                                                                          {
                                                                                                            "type": "Global",
                                                                                                            "id": 1,
                                                                                                            "name": "web",
                                                                                                            "active": true,
                                                                                                            "events": [
                                                                                                              "organization",
                                                                                                              "user"
                                                                                                            ],
                                                                                                            "config": {
                                                                                                              "url": "https://example.com",
                                                                                                              "content_type": "json",
                                                                                                              "insecure_ssl": "0",
                                                                                                              "secret": "********"
                                                                                                            },
                                                                                                            "updated_at": "2017-12-07T00:14:59Z",
                                                                                                            "created_at": "2017-12-07T00:14:59Z",
                                                                                                            "url": "https://api.github.com/admin/hooks/1",
                                                                                                            "ping_url": "https://api.github.com/admin/hooks/1/pings"
                                                                                                          }
                                                                                                          

                                                                                                          Edit a global hook

                                                                                                          Note: The Global Webhooks API is currently available for developers to preview. To access the API during the preview period, you must provide a custom media type in the Accept header:

                                                                                                          application/vnd.github.superpro-preview+json
                                                                                                          

                                                                                                          Warning: The API may change without advance notice during the preview period. Preview features are not supported for production use. If you experience any issues, contact GitHub support.

                                                                                                          Parameters that are not provided will be overwritten with the default value or removed if no default exists.

                                                                                                          PATCH /admin/hooks/:id
                                                                                                          

                                                                                                          Parameters

                                                                                                          Name Type Description
                                                                                                          config object Required. Key/value pairs to provide settings for this webhook. These are defined below.
                                                                                                          events array The events that trigger this webhook. A global webhook can be triggered by user and organization events. Default: user and organization.
                                                                                                          active boolean Determines if notifications are sent when the webhook is triggered. Set to true to send notifications. Default: true.

                                                                                                          The config object can accept the following keys:

                                                                                                          Name Type Description
                                                                                                          url string Required The URL to which the payloads will be delivered.
                                                                                                          content_type string The media type used to serialize the payloads. Supported values include json and form. The default is form.
                                                                                                          secret string If provided, the secret will be used as the key to generate the HMAC hex digest value in the X-Hub-Signature header.
                                                                                                          insecure_ssl string Determines whether the SSL certificate of the host for url will be verified when delivering payloads. Supported values include 0 (verification is performed) and 1 (verification is not performed). The default is 0. We strongly recommend not setting this to 1 as you are subject to man-in-the-middle and other attacks.

                                                                                                          Example

                                                                                                          {
                                                                                                            "name": "web",
                                                                                                            "events": [
                                                                                                              "organization"
                                                                                                            ],
                                                                                                            "config": {
                                                                                                              "url": "https://example.com/webhook"
                                                                                                            }
                                                                                                          }
                                                                                                          

                                                                                                          Response

                                                                                                          Status: 200 OK
                                                                                                          
                                                                                                          {
                                                                                                            "type": "Global",
                                                                                                            "id": 1,
                                                                                                            "name": "web",
                                                                                                            "active": true,
                                                                                                            "events": [
                                                                                                              "organization"
                                                                                                            ],
                                                                                                            "config": {
                                                                                                              "url": "https://example.com",
                                                                                                              "content_type": "form",
                                                                                                              "insecure_ssl": "0"
                                                                                                            },
                                                                                                            "updated_at": "2017-12-07T00:14:59Z",
                                                                                                            "created_at": "2017-12-07T00:14:59Z",
                                                                                                            "url": "https://api.github.com/admin/hooks/1",
                                                                                                            "ping_url": "https://api.github.com/admin/hooks/1/pings"
                                                                                                          }
                                                                                                          

                                                                                                          Ping a global hook

                                                                                                          Note: The Global Webhooks API is currently available for developers to preview. To access the API during the preview period, you must provide a custom media type in the Accept header:

                                                                                                          application/vnd.github.superpro-preview+json
                                                                                                          

                                                                                                          Warning: The API may change without advance notice during the preview period. Preview features are not supported for production use. If you experience any issues, contact GitHub support.

                                                                                                          This will trigger a ping event to be sent to the hook.

                                                                                                          POST /admin/hooks/:id/pings
                                                                                                          

                                                                                                          Response

                                                                                                          Status: 204 No Content
                                                                                                          

                                                                                                          Delete a global hook

                                                                                                          Note: The Global Webhooks API is currently available for developers to preview. To access the API during the preview period, you must provide a custom media type in the Accept header:

                                                                                                          application/vnd.github.superpro-preview+json
                                                                                                          

                                                                                                          Warning: The API may change without advance notice during the preview period. Preview features are not supported for production use. If you experience any issues, contact GitHub support.

                                                                                                          DELETE /admin/hooks/:id
                                                                                                          

                                                                                                          Response

                                                                                                          Status: 204 No Content
                                                                                                          

                                                                                                          Receiving Webhooks

                                                                                                          In order for GitHub to send webhook payloads, your server needs to be accessible from the Internet. We also highly suggest using SSL so that we can send encrypted payloads over HTTPS.

                                                                                                          For more best practices, see our guide.

                                                                                                          Webhook headers

                                                                                                          GitHub will send along several HTTP headers to differentiate between event types and payload identifiers. See webhook headers for details.

                                                                                                          tmp/developer.github.com/v3/enterprise-admin/ldap/index.html LDAP | GitHub Developer Guide

                                                                                                          LDAP

                                                                                                          You can use the LDAP API to update account relationships between a GitHub Enterprise user or team and its linked LDAP entry or queue a new synchronization.

                                                                                                          With the LDAP mapping endpoints, you're able to update the Distinguished Name (DN) that a user or team maps to. Note that the LDAP endpoints are generally only effective if your GitHub Enterprise appliance has LDAP Sync enabled. As of GitHub Enterprise 2.3.1, the Update LDAP mapping for a user can be used when LDAP is enabled, even if LDAP Sync is disabled.

                                                                                                          Update LDAP mapping for a user

                                                                                                          PATCH /admin/ldap/users/:username/mapping
                                                                                                          

                                                                                                          Body parameters

                                                                                                          Pass a JSON payload with the new LDAP Distinguished Name.

                                                                                                          Example

                                                                                                          '{"ldap_dn": "uid=asdf,ou=users,dc=github,dc=com"}'
                                                                                                          

                                                                                                          Response

                                                                                                          Status: 200 OK
                                                                                                          
                                                                                                          {
                                                                                                            "ldap_dn": "uid=asdf,ou=users,dc=github,dc=com",
                                                                                                            "login": "octocat",
                                                                                                            "id": 1,
                                                                                                            "avatar_url": "https://github.com/images/error/octocat_happy.gif",
                                                                                                            "gravatar_id": "",
                                                                                                            "url": "https://api.github.com/users/octocat",
                                                                                                            "html_url": "https://github.com/octocat",
                                                                                                            "followers_url": "https://api.github.com/users/octocat/followers",
                                                                                                            "following_url": "https://api.github.com/users/octocat/following{/other_user}",
                                                                                                            "gists_url": "https://api.github.com/users/octocat/gists{/gist_id}",
                                                                                                            "starred_url": "https://api.github.com/users/octocat/starred{/owner}{/repo}",
                                                                                                            "subscriptions_url": "https://api.github.com/users/octocat/subscriptions",
                                                                                                            "organizations_url": "https://api.github.com/users/octocat/orgs",
                                                                                                            "repos_url": "https://api.github.com/users/octocat/repos",
                                                                                                            "events_url": "https://api.github.com/users/octocat/events{/privacy}",
                                                                                                            "received_events_url": "https://api.github.com/users/octocat/received_events",
                                                                                                            "type": "User",
                                                                                                            "site_admin": false
                                                                                                          }
                                                                                                          

                                                                                                          Sync LDAP mapping for a user

                                                                                                          Note that this API call does not automatically initiate an LDAP sync. Rather, if a 201 is returned, the sync job is queued successfully, and is performed when the instance is ready.

                                                                                                          POST /admin/ldap/users/:username/sync
                                                                                                          

                                                                                                          Response

                                                                                                          Status: 201 Created
                                                                                                          
                                                                                                          {
                                                                                                            "status": "queued"
                                                                                                          }
                                                                                                          

                                                                                                          Update LDAP mapping for a team

                                                                                                          Note: The Nested Teams API is currently available for developers to preview. See the blog post for full details. To access the API, you must provide a custom media type in the Accept header:

                                                                                                          application/vnd.github.hellcat-preview+json
                                                                                                          

                                                                                                          Warning: The API may change without advance notice during the preview period. Preview features are not supported for production use. If you experience any issues, contact GitHub support.

                                                                                                          PATCH /admin/ldap/teams/:team_id/mapping
                                                                                                          

                                                                                                          Body parameters

                                                                                                          Pass a JSON payload with the new LDAP Distinguished Name.

                                                                                                          Example

                                                                                                          '{"ldap_dn": "cn=Enterprise Ops,ou=teams,dc=github,dc=com"}'
                                                                                                          

                                                                                                          Response

                                                                                                          Status: 200 OK
                                                                                                          
                                                                                                          {
                                                                                                            "ldap_dn": "cn=Enterprise Ops,ou=teams,dc=github,dc=com",
                                                                                                            "id": 1,
                                                                                                            "url": "https://api.github.com/teams/1",
                                                                                                            "name": "Justice League",
                                                                                                            "slug": "justice-league",
                                                                                                            "description": "A great team.",
                                                                                                            "privacy": "closed",
                                                                                                            "permission": "admin",
                                                                                                            "members_url": "https://api.github.com/teams/1/members{/member}",
                                                                                                            "repositories_url": "https://api.github.com/teams/1/repos",
                                                                                                            "parent": null
                                                                                                          }
                                                                                                          

                                                                                                          Sync LDAP mapping for a team

                                                                                                          Note that this API call does not automatically initiate an LDAP sync. Rather, if a 201 is returned, the sync job is queued successfully, and is performed when the instance is ready.

                                                                                                          POST /admin/ldap/teams/:team_id/sync
                                                                                                          

                                                                                                          Response

                                                                                                          Status: 201 Created
                                                                                                          
                                                                                                          {
                                                                                                            "status": "queued"
                                                                                                          }
                                                                                                          
                                                                                                          tmp/developer.github.com/v3/enterprise-admin/license/index.html License | GitHub Developer Guide

                                                                                                          License

                                                                                                          The License API provides information on your Enterprise license. It is only available to authenticated site administrators. Normal users will receive a 404 response if they try to access it.

                                                                                                          Prefix all the endpoints for this API with the following URL:

                                                                                                          http(s)://hostname/api/v3
                                                                                                          

                                                                                                          Get license information

                                                                                                          Request

                                                                                                          GET /enterprise/settings/license
                                                                                                          

                                                                                                          Response

                                                                                                          Status: 200 OK
                                                                                                          
                                                                                                          {
                                                                                                            "seats": 1400,
                                                                                                            "seats_used": 1316,
                                                                                                            "seats_available": 84,
                                                                                                            "kind": "standard",
                                                                                                            "days_until_expiration": 365,
                                                                                                            "expire_at": "2016/02/06 12:41:52 -0600"
                                                                                                          }
                                                                                                          
                                                                                                          tmp/developer.github.com/v3/enterprise-admin/management_console/index.html Management Console | GitHub Developer Guide

                                                                                                          Management Console

                                                                                                          The Management Console API helps you manage your GitHub Enterprise installation.

                                                                                                          You must explicitly set the port number when making API calls to the Management Console. If TLS is enabled on your Enterprise instance, the port number is 8443; otherwise, the port number is 8080.

                                                                                                          If you don't want to provide a port number, you'll need to configure your tool to automatically follow redirects.

                                                                                                          You may also need to add the -k flag when using curl, since GitHub Enterprise uses a self-signed certificate before you add your own TLS certificate.

                                                                                                          Authentication

                                                                                                          You need to pass your Management Console password as an authentication token to every Management Console API endpoint except /setup/api/start.

                                                                                                          Use the api_key parameter to send this token with each request. For example:

                                                                                                          curl -L 'https://hostname:admin_port/setup/api?api_key=your-amazing-password'
                                                                                                          

                                                                                                          You can also use standard HTTP authentication to send this token. For example:

                                                                                                          curl -L 'https://api_key:your-amazing-password@hostname:admin_port/setup/api'
                                                                                                          

                                                                                                          Upload a license for the first time

                                                                                                          When you boot a virtual machine for the first time, you can use the following endpoint to upload a license:

                                                                                                          POST /setup/api/start
                                                                                                          

                                                                                                          Note that you need to POST to /setup/api/configure to start the actual configuration process.

                                                                                                          When using this endpoint, your Enterprise instance must have a password set. This can be accomplished two ways:

                                                                                                          1. If you're working directly with the API before accessing the web interface, you must pass in the password parameter to set your password.
                                                                                                          2. If you set up your instance via the web interface before accessing the API, your calls to this endpoint do not need the password parameter.

                                                                                                          Parameters

                                                                                                          Name Type Description
                                                                                                          license string Required. The content of your .ghl license file.
                                                                                                          password string You must provide a password only if you are uploading your license for the first time. If you previously set a password through the web interface, you don't need this parameter.
                                                                                                          settings string An optional JSON string containing the installation settings.

                                                                                                          For a list of the available settings, see the /setup/api/settings endpoint.

                                                                                                          Response

                                                                                                          HTTP/1.1 202 Created
                                                                                                          Location: http://hostname:admin_port/setup/api/configcheck
                                                                                                          

                                                                                                          Example

                                                                                                          curl -L -X POST 'https://hostname:admin_port/setup/api/start' -F license=@/path/to/github-enterprise.ghl -F "password=your-amazing-password" -F settings=</path/to/settings.json
                                                                                                          

                                                                                                          Upgrade a license

                                                                                                          This API upgrades your license and also triggers the configuration process:

                                                                                                          POST /setup/api/upgrade
                                                                                                          

                                                                                                          Parameters

                                                                                                          Name Type Description
                                                                                                          license string The content of your new .ghl license file.

                                                                                                          Response

                                                                                                          HTTP/1.1 202 Accepted
                                                                                                          Location: http://hostname:admin_port/setup/api/configcheck
                                                                                                          

                                                                                                          Example

                                                                                                          curl -L -X POST 'https://api_key:your-amazing-password@hostname:admin_port/setup/api/upgrade'
                                                                                                          

                                                                                                          Check configuration status

                                                                                                          This endpoint allows you to check the status of the most recent configuration process:

                                                                                                          GET /setup/api/configcheck
                                                                                                          

                                                                                                          Note that you may need to wait several seconds after you start a process before you can check its status.

                                                                                                          Response

                                                                                                          Status: 200 OK
                                                                                                          
                                                                                                          {
                                                                                                            "status": "running",
                                                                                                            "progress": [
                                                                                                              {
                                                                                                                "status": "DONE",
                                                                                                                "key": "Appliance core components"
                                                                                                              },
                                                                                                              {
                                                                                                                "status": "DONE",
                                                                                                                "key": "GitHub utilities"
                                                                                                              },
                                                                                                              {
                                                                                                                "status": "DONE",
                                                                                                                "key": "GitHub applications"
                                                                                                              },
                                                                                                              {
                                                                                                                "status": "CONFIGURING",
                                                                                                                "key": "GitHub services"
                                                                                                              },
                                                                                                              {
                                                                                                                "status": "PENDING",
                                                                                                                "key": "Reloading appliance services"
                                                                                                              }
                                                                                                            ]
                                                                                                          }
                                                                                                          

                                                                                                          The different statuses are:

                                                                                                          Status Description
                                                                                                          PENDING The job has not started yet
                                                                                                          CONFIGURING The job is running
                                                                                                          DONE The job has finished correctly
                                                                                                          FAILED The job has finished unexpectedly

                                                                                                          Example

                                                                                                          curl -L 'https://api_key:your-amazing-password@hostname:admin_port/setup/api/configcheck'
                                                                                                          

                                                                                                          Start a configuration process

                                                                                                          This endpoint allows you to start a configuration process at any time for your updated settings to take effect:

                                                                                                          POST /setup/api/configure
                                                                                                          

                                                                                                          Response

                                                                                                          HTTP/1.1 202 Accepted
                                                                                                          Location: http://hostname:admin_port/setup/api/configcheck
                                                                                                          

                                                                                                          Example

                                                                                                          curl -L -X POST 'https://api_key:your-amazing-password@hostname:admin_port/setup/api/configure'
                                                                                                          

                                                                                                          Retrieve settings

                                                                                                          GET /setup/api/settings
                                                                                                          

                                                                                                          Response

                                                                                                          Status: 200 OK
                                                                                                          
                                                                                                          {
                                                                                                            "enterprise": {
                                                                                                              "private_mode": false,
                                                                                                              "public_pages": false,
                                                                                                              "subdomain_isolation": true,
                                                                                                              "signup_enabled": false,
                                                                                                              "github_hostname": "ghe.local",
                                                                                                              "identicons_host": "dotcom",
                                                                                                              "http_proxy": null,
                                                                                                              "auth_mode": "default",
                                                                                                              "expire_sessions": false,
                                                                                                              "admin_password": null,
                                                                                                              "configuration_id": 1401777404,
                                                                                                              "configuration_run_count": 4,
                                                                                                              "avatar": {
                                                                                                                "enabled": false,
                                                                                                                "uri": ""
                                                                                                              },
                                                                                                              "customer": {
                                                                                                                "name": "GitHub",
                                                                                                                "email": "stannis@themannis.biz",
                                                                                                                "uuid": "af6cac80-e4e1-012e-d822-1231380e52e9",
                                                                                                                "secret_key_data": "-----BEGIN PGP PRIVATE KEY BLOCK-----\nVersion: GnuPG v1.4.10 (GNU/Linux)\n\nlQcYBE5TCgsBEACk4yHpUcapplebaumBMXYMiLF+nCQ0lxpx...\n-----END PGP PRIVATE KEY BLOCK-----\n",
                                                                                                                "public_key_data": "-----BEGIN PGP PUBLIC KEY BLOCK-----\nVersion: GnuPG v1.4.10 (GNU/Linux)\n\nmI0ETqzZYgEEALSe6snowdenXyqvLfSQ34HWD6C7....\n-----END PGP PUBLIC KEY BLOCK-----\n"
                                                                                                              },
                                                                                                              "license": {
                                                                                                                "seats": 0,
                                                                                                                "evaluation": false,
                                                                                                                "perpetual": false,
                                                                                                                "unlimited_seating": true,
                                                                                                                "support_key": "ssh-rsa AAAAB3N....",
                                                                                                                "ssh_allowed": true,
                                                                                                                "cluster_support": false,
                                                                                                                "expire_at": "2016-04-27T00:00:00-07:00"
                                                                                                              },
                                                                                                              "github_ssl": {
                                                                                                                "enabled": false,
                                                                                                                "cert": null,
                                                                                                                "key": null
                                                                                                              },
                                                                                                              "ldap": {
                                                                                                                "host": null,
                                                                                                                "port": 0,
                                                                                                                "base": [
                                                                                                          
                                                                                                                ],
                                                                                                                "uid": null,
                                                                                                                "bind_dn": null,
                                                                                                                "password": null,
                                                                                                                "method": "Plain",
                                                                                                                "search_strategy": "detect",
                                                                                                                "user_groups": [
                                                                                                          
                                                                                                                ],
                                                                                                                "admin_group": null,
                                                                                                                "virtual_attribute_enabled": false,
                                                                                                                "recursive_group_search": false,
                                                                                                                "posix_support": true,
                                                                                                                "user_sync_emails": false,
                                                                                                                "user_sync_keys": false,
                                                                                                                "user_sync_interval": 4,
                                                                                                                "team_sync_interval": 4,
                                                                                                                "sync_enabled": false,
                                                                                                                "reconciliation": {
                                                                                                                  "user": null,
                                                                                                                  "org": null
                                                                                                                },
                                                                                                                "profile": {
                                                                                                                  "uid": "uid",
                                                                                                                  "name": null,
                                                                                                                  "mail": null,
                                                                                                                  "key": null
                                                                                                                }
                                                                                                              },
                                                                                                              "cas": {
                                                                                                                "url": null
                                                                                                              },
                                                                                                              "saml": {
                                                                                                                "sso_url": null,
                                                                                                                "certificate": null,
                                                                                                                "certificate_path": null,
                                                                                                                "issuer": null,
                                                                                                                "idp_initiated_sso": false,
                                                                                                                "disable_admin_demote": false
                                                                                                              },
                                                                                                              "github_oauth": {
                                                                                                                "client_id": "12313412",
                                                                                                                "client_secret": "kj123131132",
                                                                                                                "organization_name": "Homestar Runners",
                                                                                                                "organization_team": "homestarrunners/characters"
                                                                                                              },
                                                                                                              "smtp": {
                                                                                                                "enabled": true,
                                                                                                                "address": "smtp.example.com",
                                                                                                                "authentication": "plain",
                                                                                                                "port": "1234",
                                                                                                                "domain": "blah",
                                                                                                                "username": "foo",
                                                                                                                "user_name": "mr_foo",
                                                                                                                "enable_starttls_auto": true,
                                                                                                                "password": "bar",
                                                                                                                "support_address": "enterprise@github.com",
                                                                                                                "noreply_address": "noreply@github.com"
                                                                                                              },
                                                                                                              "ntp": {
                                                                                                                "primary_server": "0.pool.ntp.org",
                                                                                                                "secondary_server": "1.pool.ntp.org"
                                                                                                              },
                                                                                                              "timezone": null,
                                                                                                              "snmp": {
                                                                                                                "enabled": false,
                                                                                                                "community": ""
                                                                                                              },
                                                                                                              "syslog": {
                                                                                                                "enabled": false,
                                                                                                                "server": null,
                                                                                                                "protocol_name": "udp"
                                                                                                              },
                                                                                                              "assets": null,
                                                                                                              "pages": {
                                                                                                                "enabled": true
                                                                                                              },
                                                                                                              "collectd": {
                                                                                                                "enabled": false,
                                                                                                                "server": null,
                                                                                                                "port": 0,
                                                                                                                "encryption": null,
                                                                                                                "username": null,
                                                                                                                "password": null
                                                                                                              },
                                                                                                              "mapping": {
                                                                                                                "enabled": true,
                                                                                                                "tileserver": null,
                                                                                                                "basemap": "company.map-qsz2zrvs",
                                                                                                                "token": null
                                                                                                              },
                                                                                                              "load_balancer": null
                                                                                                            },
                                                                                                            "run_list": [
                                                                                                              "recipe[enterprise-configure]"
                                                                                                            ]
                                                                                                          }
                                                                                                          

                                                                                                          Example

                                                                                                          curl -L 'https://api_key:your-amazing-password@hostname:admin_port/setup/api/settings'
                                                                                                          

                                                                                                          Modify settings

                                                                                                          PUT /setup/api/settings
                                                                                                          

                                                                                                          Parameters

                                                                                                          Name Type Description
                                                                                                          settings string Required. A JSON string with the new settings. Note that you only need to pass the specific settings you want to modify.

                                                                                                          Response

                                                                                                          HTTP/1.1 204 No Content
                                                                                                          

                                                                                                          Example

                                                                                                          curl -L -X PUT 'https://api_key:your-amazing-password@hostname:admin_port/setup/api/settings' --data-urlencode "settings=`cat /path/to/settings.json`"
                                                                                                          

                                                                                                          Check maintenance status

                                                                                                          Check your installation's maintenance status:

                                                                                                          GET /setup/api/maintenance
                                                                                                          

                                                                                                          Response

                                                                                                          Status: 200 OK
                                                                                                          
                                                                                                          {
                                                                                                            "status": "scheduled",
                                                                                                            "scheduled_time": "Tuesday, January 22 at 15 => 34 -0800",
                                                                                                            "connection_services": [
                                                                                                              {
                                                                                                                "name": "git operations",
                                                                                                                "number": 0
                                                                                                              },
                                                                                                              {
                                                                                                                "name": "mysql queries",
                                                                                                                "number": 233
                                                                                                              },
                                                                                                              {
                                                                                                                "name": "resque jobs",
                                                                                                                "number": 54
                                                                                                              }
                                                                                                            ]
                                                                                                          }
                                                                                                          

                                                                                                          Example

                                                                                                          curl -L 'https://api_key:your-amazing-password@hostname:admin_port/setup/api/maintenance'
                                                                                                          

                                                                                                          Enable or disable maintenance mode

                                                                                                          POST /setup/api/maintenance
                                                                                                          

                                                                                                          Parameters

                                                                                                          Name Type Description
                                                                                                          maintenance string Required. A JSON string with the attributes enabled and when.

                                                                                                          The possible values for enabled are true and false. When it's false, the attribute when is ignored and the maintenance mode is turned off. when defines the time period when the maintenance was enabled.

                                                                                                          The possible values for when are now or any date parseable by mojombo/chronic.

                                                                                                          Response

                                                                                                          Status: 200 OK
                                                                                                          
                                                                                                          {
                                                                                                            "status": "scheduled",
                                                                                                            "scheduled_time": "Tuesday, January 22 at 15 => 34 -0800",
                                                                                                            "connection_services": [
                                                                                                              {
                                                                                                                "name": "git operations",
                                                                                                                "number": 0
                                                                                                              },
                                                                                                              {
                                                                                                                "name": "mysql queries",
                                                                                                                "number": 233
                                                                                                              },
                                                                                                              {
                                                                                                                "name": "resque jobs",
                                                                                                                "number": 54
                                                                                                              }
                                                                                                            ]
                                                                                                          }
                                                                                                          

                                                                                                          Example

                                                                                                          curl -L -X POST 'https://api_key:your-amazing-password@hostname:admin_port/setup/api/maintenance' -d 'maintenance={"enabled":true, "when":"now"}'
                                                                                                          

                                                                                                          Retrieve authorized SSH keys

                                                                                                          GET /setup/api/settings/authorized-keys
                                                                                                          

                                                                                                          Response

                                                                                                          Status: 200 OK
                                                                                                          
                                                                                                          [
                                                                                                            {
                                                                                                              "key": "ssh-rsa AAAAB3NzaC1yc2EAAAAB...",
                                                                                                              "pretty-print": "ssh-rsa 01:14:0f:f2:0f:e2:fe:e8:f4:72:62:af:75:f7:1a:88:3e:04:92:64"
                                                                                                            },
                                                                                                            {
                                                                                                              "key": "ssh-rsa AAAAB3NzaC1yc2EAAAAB...",
                                                                                                              "pretty-print": "ssh-rsa 01:14:0f:f2:0f:e2:fe:e8:f4:72:62:af:75:f7:1a:88:3e:04:92:64"
                                                                                                            }
                                                                                                          ]
                                                                                                          

                                                                                                          Example

                                                                                                          curl -L 'https://api_key:your-amazing-password@hostname:admin_port/setup/api/settings/authorized-keys'
                                                                                                          

                                                                                                          Add a new authorized SSH key

                                                                                                          POST /setup/api/settings/authorized-keys
                                                                                                          

                                                                                                          Parameters

                                                                                                          Name Type Description
                                                                                                          authorized_key string Required. The path to the public SSH key.

                                                                                                          Response

                                                                                                          Status: 201 Created
                                                                                                          
                                                                                                          [
                                                                                                            {
                                                                                                              "key": "ssh-rsa AAAAB3NzaC1yc2EAAAAB...",
                                                                                                              "pretty-print": "ssh-rsa 01:14:0f:f2:0f:e2:fe:e8:f4:72:62:af:75:f7:1a:88:3e:04:92:64"
                                                                                                            },
                                                                                                            {
                                                                                                              "key": "ssh-rsa AAAAB3NzaC1yc2EAAAAB...",
                                                                                                              "pretty-print": "ssh-rsa 01:14:0f:f2:0f:e2:fe:e8:f4:72:62:af:75:f7:1a:88:3e:04:92:64"
                                                                                                            },
                                                                                                            {
                                                                                                              "key": "ssh-rsa AAAAB3NzaC1yc2EAAAAB...",
                                                                                                              "pretty-print": "ssh-rsa 01:14:0f:f2:0f:e2:fe:e8:f4:72:62:af:75:f7:1a:88:3e:04:92:64"
                                                                                                            }
                                                                                                          ]
                                                                                                          

                                                                                                          Example

                                                                                                          curl -L -X POST 'https://api_key:your-amazing-password@hostname:admin_port/setup/api/settings/authorized-keys' -F authorized_key=@/path/to/key.pub
                                                                                                          

                                                                                                          Remove an authorized SSH key

                                                                                                          DELETE /setup/api/settings/authorized-keys
                                                                                                          

                                                                                                          Parameters

                                                                                                          Name Type Description
                                                                                                          authorized_key string Required. The path to the public SSH key.

                                                                                                          Response

                                                                                                          Status: 200 OK
                                                                                                          
                                                                                                          [
                                                                                                            {
                                                                                                              "key": "ssh-rsa AAAAB3NzaC1yc2EAAAAB...",
                                                                                                              "pretty-print": "ssh-rsa 01:14:0f:f2:0f:e2:fe:e8:f4:72:62:af:75:f7:1a:88:3e:04:92:64"
                                                                                                            },
                                                                                                            {
                                                                                                              "key": "ssh-rsa AAAAB3NzaC1yc2EAAAAB...",
                                                                                                              "pretty-print": "ssh-rsa 01:14:0f:f2:0f:e2:fe:e8:f4:72:62:af:75:f7:1a:88:3e:04:92:64"
                                                                                                            }
                                                                                                          ]
                                                                                                          

                                                                                                          Example

                                                                                                          curl -L -X DELETE 'https://api_key:your-amazing-password@hostname:admin_port/setup/api/settings/authorized-keys' -F authorized_key=@/path/to/key.pub
                                                                                                          
                                                                                                          tmp/developer.github.com/v3/enterprise-admin/orgs/index.html Organization Administration | GitHub Developer Guide

                                                                                                          Organization Administration

                                                                                                          The Organization Administration API allows you to create organizations on a GitHub Enterprise appliance. It is only available to authenticated site administrators. Normal users will receive a 404 response if they try to access it.

                                                                                                          Prefix all the endpoints for this API with the following URL:

                                                                                                          http(s)://hostname/api/v3
                                                                                                          

                                                                                                          Create an organization

                                                                                                          POST /admin/organizations
                                                                                                          

                                                                                                          Parameters

                                                                                                          Name Type Description
                                                                                                          login string Required. The organization's username.
                                                                                                          admin string Required. The login of the user who will manage this organization.
                                                                                                          profile_name string The organization's display name.

                                                                                                          Example

                                                                                                          {
                                                                                                            "login": "github",
                                                                                                            "profile_name": "GitHub, Inc.",
                                                                                                            "admin": "monalisaoctocat"
                                                                                                          }
                                                                                                          

                                                                                                          Response

                                                                                                          Status: 201 Created
                                                                                                          
                                                                                                          {
                                                                                                            "login": "github",
                                                                                                            "id": 1,
                                                                                                            "url": "https://api.github.com/orgs/github",
                                                                                                            "repos_url": "https://api.github.com/orgs/github/repos",
                                                                                                            "events_url": "https://api.github.com/orgs/github/events",
                                                                                                            "hooks_url": "https://api.github.com/orgs/github/hooks",
                                                                                                            "issues_url": "https://api.github.com/orgs/github/issues",
                                                                                                            "members_url": "https://api.github.com/orgs/github/members{/member}",
                                                                                                            "public_members_url": "https://api.github.com/orgs/github/public_members{/member}",
                                                                                                            "avatar_url": "https://github.com/images/error/octocat_happy.gif",
                                                                                                            "description": "A great organization"
                                                                                                          }
                                                                                                          

                                                                                                          Rename an organization

                                                                                                          PATCH /admin/organizations/:org
                                                                                                          

                                                                                                          Parameters

                                                                                                          Name Type Description
                                                                                                          login string Required. The organization's new name.

                                                                                                          Example

                                                                                                          {
                                                                                                            "login": "the-new-octocats"
                                                                                                          }
                                                                                                          

                                                                                                          Response

                                                                                                          Status: 202 Accepted
                                                                                                          
                                                                                                          {
                                                                                                            "message": "Job queued to rename organization. It may take a few minutes to complete.",
                                                                                                            "url": "https://<hostname>/api/v3/organizations/1"
                                                                                                          }
                                                                                                          
                                                                                                          tmp/developer.github.com/v3/enterprise-admin/pre_receive_environments/index.html Pre-receive Environments | GitHub Developer Guide

                                                                                                          Pre-receive Environments

                                                                                                          APIs for managing pre-receive hooks are currently available for developers to preview. During the preview period, the APIs may change without advance notice.

                                                                                                          To access the API you must provide a custom media type in the Accept header:

                                                                                                            application/vnd.github.eye-scream-preview
                                                                                                          

                                                                                                          The Pre-receive Environments API allows you to create, list, update and delete environments for pre-receive hooks. It is only available to authenticated site administrators. Normal users will receive a 404 response if they try to access it.

                                                                                                          Prefix all the endpoints for this API with the following URL:

                                                                                                          http(s)://hostname/api/v3
                                                                                                          

                                                                                                          Object attributes

                                                                                                          Pre-receive Environment

                                                                                                          Name Type Description
                                                                                                          name string The name of the environment as displayed in the UI.
                                                                                                          image_url string URL to the tarball that will be downloaded and extracted.
                                                                                                          default_environment boolean Whether this is the default environment that ships with GitHub Enterprise.
                                                                                                          download object This environment's download status.
                                                                                                          hooks_count integer The number of pre-receive hooks that use this environment.

                                                                                                          Pre-receive Environment Download

                                                                                                          Name Type Description
                                                                                                          state string The state of the most recent download.
                                                                                                          downloaded_at string The time when the most recent download started.
                                                                                                          message string On failure, this will have any error messages produced.

                                                                                                          Possible values for state are not_started, in_progress, success, failed.

                                                                                                          Get a single pre-receive environment

                                                                                                          GET /admin/pre-receive-environments/:id
                                                                                                          
                                                                                                          Status: 200 OK
                                                                                                          
                                                                                                          {
                                                                                                            "id": 2,
                                                                                                            "name": "DevTools Hook Env",
                                                                                                            "image_url": "https://my_file_server/path/to/devtools_env.tar.gz",
                                                                                                            "url": "https://github.example.com/api/v3/admin/pre-receive-environments/2",
                                                                                                            "html_url": "https://github.example.com/admin/pre-receive-environments/2",
                                                                                                            "default_environment": false,
                                                                                                            "created_at": "2016-05-20T11:35:45-05:00",
                                                                                                            "hooks_count": 1,
                                                                                                            "download": {
                                                                                                              "url": "https://github.example.com/api/v3/admin/pre-receive-environments/2/downloads/latest",
                                                                                                              "state": "success",
                                                                                                              "downloaded_at": "2016-05-26T07:42:53-05:00",
                                                                                                              "message": null
                                                                                                            }
                                                                                                          }
                                                                                                          

                                                                                                          List pre-receive environments

                                                                                                          GET /admin/pre-receive-environments
                                                                                                          
                                                                                                          Status: 200 OK
                                                                                                          Link: <https://api.github.com/resource?page=2>; rel="next",
                                                                                                                <https://api.github.com/resource?page=5>; rel="last"
                                                                                                          
                                                                                                          [
                                                                                                            {
                                                                                                              "id": 1,
                                                                                                              "name": "Default",
                                                                                                              "image_url": "githubenterprise://internal",
                                                                                                              "url": "https://github.example.com/api/v3/admin/pre-receive-environments/1",
                                                                                                              "html_url": "https://github.example.com/admin/pre-receive-environments/1",
                                                                                                              "default_environment": true,
                                                                                                              "created_at": "2016-05-20T11:35:45-05:00",
                                                                                                              "hooks_count": 14,
                                                                                                              "download": {
                                                                                                                "url": "https://github.example.com/api/v3/admin/pre-receive-environments/1/downloads/latest",
                                                                                                                "state": "not_started",
                                                                                                                "downloaded_at": "2016-05-26T07:42:53-05:00",
                                                                                                                "message": null
                                                                                                              }
                                                                                                            },
                                                                                                            {
                                                                                                              "id": 2,
                                                                                                              "name": "DevTools Hook Env",
                                                                                                              "image_url": "https://my_file_server/path/to/devtools_env.tar.gz",
                                                                                                              "url": "https://github.example.com/api/v3/admin/pre-receive-environments/2",
                                                                                                              "html_url": "https://github.example.com/admin/pre-receive-environments/2",
                                                                                                              "default_environment": false,
                                                                                                              "created_at": "2016-05-20T11:35:45-05:00",
                                                                                                              "hooks_count": 1,
                                                                                                              "download": {
                                                                                                                "url": "https://github.example.com/api/v3/admin/pre-receive-environments/2/downloads/latest",
                                                                                                                "state": "success",
                                                                                                                "downloaded_at": "2016-05-26T07:42:53-05:00",
                                                                                                                "message": null
                                                                                                              }
                                                                                                            }
                                                                                                          ]
                                                                                                          

                                                                                                          Create a pre-receive environment

                                                                                                          POST /admin/pre-receive-environments
                                                                                                          

                                                                                                          Parameters

                                                                                                          Name Type Description
                                                                                                          name string Required. The new pre-receive environment's name.
                                                                                                          image_url string Required. URL from which to download a tarball of this environment.
                                                                                                          {
                                                                                                            "name": "DevTools Hook Env",
                                                                                                            "image_url": "https://my_file_server/path/to/devtools_env.tar.gz"
                                                                                                          }
                                                                                                          

                                                                                                          Response

                                                                                                          Status: 201 Created
                                                                                                          
                                                                                                          {
                                                                                                            "id": 2,
                                                                                                            "name": "DevTools Hook Env",
                                                                                                            "image_url": "https://my_file_server/path/to/devtools_env.tar.gz",
                                                                                                            "url": "https://github.example.com/api/v3/admin/pre-receive-environments/2",
                                                                                                            "html_url": "https://github.example.com/admin/pre-receive-environments/2",
                                                                                                            "default_environment": false,
                                                                                                            "created_at": "2016-05-20T11:35:45-05:00",
                                                                                                            "hooks_count": 1,
                                                                                                            "download": {
                                                                                                              "url": "https://github.example.com/api/v3/admin/pre-receive-environments/2/downloads/latest",
                                                                                                              "state": "not_started",
                                                                                                              "downloaded_at": null,
                                                                                                              "message": null
                                                                                                            }
                                                                                                          }
                                                                                                          

                                                                                                          Edit a pre-receive environment

                                                                                                          PATCH /admin/pre-receive-environments/:id
                                                                                                          

                                                                                                          Parameters

                                                                                                          Name Type Description
                                                                                                          name string This pre-receive environment's new name.
                                                                                                          image_url string URL from which to download a tarball of this environment.

                                                                                                          Response

                                                                                                          Status: 200 OK
                                                                                                          
                                                                                                          {
                                                                                                            "id": 2,
                                                                                                            "name": "DevTools Hook Env",
                                                                                                            "image_url": "https://my_file_server/path/to/devtools_env.tar.gz",
                                                                                                            "url": "https://github.example.com/api/v3/admin/pre-receive-environments/2",
                                                                                                            "html_url": "https://github.example.com/admin/pre-receive-environments/2",
                                                                                                            "default_environment": false,
                                                                                                            "created_at": "2016-05-20T11:35:45-05:00",
                                                                                                            "hooks_count": 1,
                                                                                                            "download": {
                                                                                                              "url": "https://github.example.com/api/v3/admin/pre-receive-environments/2/downloads/latest",
                                                                                                              "state": "success",
                                                                                                              "downloaded_at": "2016-05-26T07:42:53-05:00",
                                                                                                              "message": null
                                                                                                            }
                                                                                                          }
                                                                                                          

                                                                                                          Client Errors

                                                                                                          If you attempt to modify the default environment, you will get a response like this:

                                                                                                          Status: 422 Unprocessable Entity
                                                                                                          
                                                                                                          {
                                                                                                            "message": "Validation Failed",
                                                                                                            "errors": [
                                                                                                              {
                                                                                                                "resource": "PreReceiveEnvironment",
                                                                                                                "code": "custom",
                                                                                                                "message": "Cannot modify or delete the default environment"
                                                                                                              }
                                                                                                            ]
                                                                                                          }
                                                                                                          

                                                                                                          Delete a pre-receive environment

                                                                                                          DELETE /admin/pre-receive-environments/:id
                                                                                                          

                                                                                                          Response

                                                                                                          Status: 204 No Content
                                                                                                          

                                                                                                          Client Errors

                                                                                                          If you attempt to delete an environment that cannot be deleted, you will get a response like this:

                                                                                                          Status: 422 Unprocessable Entity
                                                                                                          
                                                                                                          {
                                                                                                            "message": "Validation Failed",
                                                                                                            "errors": [
                                                                                                              {
                                                                                                                "resource": "PreReceiveEnvironment",
                                                                                                                "code": "custom",
                                                                                                                "message": "Cannot modify or delete the default environment"
                                                                                                              }
                                                                                                            ]
                                                                                                          }
                                                                                                          

                                                                                                          The possible error messages are:

                                                                                                          • Cannot modify or delete the default environment
                                                                                                          • Cannot delete environment that has hooks
                                                                                                          • Cannot delete environment when download is in progress

                                                                                                          Get a pre-receive environment's download status

                                                                                                          In addition to seeing the download status at the /admin/pre-receive-environments/:id, there is also a separate endpoint for just the status.

                                                                                                          GET /admin/pre-receive-environments/:id/downloads/latest
                                                                                                          
                                                                                                          Status: 200 OK
                                                                                                          
                                                                                                          {
                                                                                                            "url": "https://github.example.com/api/v3/admin/pre-receive-environments/3/downloads/latest",
                                                                                                            "state": "success",
                                                                                                            "downloaded_at": "2016-05-26T07:42:53-05:00",
                                                                                                            "message": null
                                                                                                          }
                                                                                                          

                                                                                                          Object attributes

                                                                                                          Name Type Description
                                                                                                          state string The state of the most recent download.
                                                                                                          downloaded_at string The time when the most recent download started.
                                                                                                          message string On failure, this will have any error messages produced.

                                                                                                          Possible values for state are not_started, in_progress, success, failed.

                                                                                                          Trigger a pre-receive environment download

                                                                                                          Triggers a new download of the environment tarball from the environment's image_url. When the download is finished, the newly downloaded tarball will overwrite the existing environment.

                                                                                                          POST /admin/pre-receive-environments/:id/downloads
                                                                                                          

                                                                                                          Response

                                                                                                          Status: 202 Accepted
                                                                                                          
                                                                                                          {
                                                                                                            "url": "https://github.example.com/api/v3/admin/pre-receive-environments/3/downloads/latest",
                                                                                                            "state": "not_started",
                                                                                                            "downloaded_at": null,
                                                                                                            "message": null
                                                                                                          }
                                                                                                          

                                                                                                          Client Errors

                                                                                                          If a download cannot be triggered, you will get a reponse like this:

                                                                                                          Status: 422 Unprocessable Entity
                                                                                                          
                                                                                                          {
                                                                                                            "message": "Validation Failed",
                                                                                                            "errors": [
                                                                                                              {
                                                                                                                "resource": "PreReceiveEnvironment",
                                                                                                                "code": "custom",
                                                                                                                "message": "Can not start a new download when a download is in progress"
                                                                                                              }
                                                                                                            ]
                                                                                                          }
                                                                                                          

                                                                                                          The possible error messages are:

                                                                                                          • Cannot modify or delete the default environment
                                                                                                          • Can not start a new download when a download is in progress
                                                                                                          tmp/developer.github.com/v3/enterprise-admin/pre_receive_hooks/index.html Pre-receive Hooks | GitHub Developer Guide

                                                                                                          Pre-receive Hooks

                                                                                                          APIs for managing pre-receive hooks are currently available for developers to preview. During the preview period, the APIs may change without advance notice.

                                                                                                          To access the API you must provide a custom media type in the Accept header:

                                                                                                            application/vnd.github.eye-scream-preview
                                                                                                          

                                                                                                          The Pre-receive Hooks API allows you to create, list, update and delete pre-receive hooks. It is only available to authenticated site administrators. Normal users will receive a 404 response if they try to access it.

                                                                                                          Prefix all the endpoints for this API with the following URL:

                                                                                                          http(s)://hostname/api/v3
                                                                                                          

                                                                                                          Object attributes

                                                                                                          Pre-receive Hook

                                                                                                          Name Type Description
                                                                                                          name string The name of the hook.
                                                                                                          script string The script that the hook runs.
                                                                                                          script_repository object The GitHub repository where the script is kept.
                                                                                                          environment object The pre-receive environment where the script is executed.
                                                                                                          enforcement string The state of enforcement for this hook.
                                                                                                          allow_downstream_configuration boolean Whether enforcement can be overridden at the org or repo level.

                                                                                                          Possible values for enforcement are enabled, disabled andtesting. disabled indicates the pre-receive hook will not run. enabled indicates it will run and reject any pushes that result in a non-zero status. testing means the script will run but will not cause any pushes to be rejected.

                                                                                                          Get a single pre-receive hook

                                                                                                          GET /admin/pre-receive-hooks/:id
                                                                                                          
                                                                                                          Status: 200 OK
                                                                                                          
                                                                                                          {
                                                                                                            "id": 1,
                                                                                                            "name": "Check Commits",
                                                                                                            "enforcement": "disabled",
                                                                                                            "script": "scripts/commmit_check.sh",
                                                                                                            "script_repository": {
                                                                                                              "id": 595,
                                                                                                              "full_name": "DevIT/hooks",
                                                                                                              "url": "https://github.example.com/api/v3/repos/DevIT/hooks",
                                                                                                              "html_url": "https://github.example.com/DevIT/hooks"
                                                                                                            },
                                                                                                            "environment": {
                                                                                                              "id": 2,
                                                                                                              "name": "DevTools Hook Env",
                                                                                                              "image_url": "https://my_file_server/path/to/devtools_env.tar.gz",
                                                                                                              "url": "https://github.example.com/api/v3/admin/pre-receive-environments/2",
                                                                                                              "html_url": "https://github.example.com/admin/pre-receive-environments/2",
                                                                                                              "default_environment": false,
                                                                                                              "created_at": "2016-05-20T11:35:45-05:00",
                                                                                                              "hooks_count": 1,
                                                                                                              "download": {
                                                                                                                "url": "https://github.example.com/api/v3/admin/pre-receive-environments/2/downloads/latest",
                                                                                                                "state": "success",
                                                                                                                "downloaded_at": "2016-05-26T07:42:53-05:00",
                                                                                                                "message": null
                                                                                                              }
                                                                                                            },
                                                                                                            "allow_downstream_configuration": false
                                                                                                          }
                                                                                                          

                                                                                                          List pre-receive hooks

                                                                                                          GET /admin/pre-receive-hooks
                                                                                                          
                                                                                                          Status: 200 OK
                                                                                                          Link: <https://api.github.com/resource?page=2>; rel="next",
                                                                                                                <https://api.github.com/resource?page=5>; rel="last"
                                                                                                          
                                                                                                          [
                                                                                                            {
                                                                                                              "id": 1,
                                                                                                              "name": "Check Commits",
                                                                                                              "enforcement": "disabled",
                                                                                                              "script": "scripts/commmit_check.sh",
                                                                                                              "script_repository": {
                                                                                                                "id": 595,
                                                                                                                "full_name": "DevIT/hooks",
                                                                                                                "url": "https://github.example.com/api/v3/repos/DevIT/hooks",
                                                                                                                "html_url": "https://github.example.com/DevIT/hooks"
                                                                                                              },
                                                                                                              "environment": {
                                                                                                                "id": 2,
                                                                                                                "name": "DevTools Hook Env",
                                                                                                                "image_url": "https://my_file_server/path/to/devtools_env.tar.gz",
                                                                                                                "url": "https://github.example.com/api/v3/admin/pre-receive-environments/2",
                                                                                                                "html_url": "https://github.example.com/admin/pre-receive-environments/2",
                                                                                                                "default_environment": false,
                                                                                                                "created_at": "2016-05-20T11:35:45-05:00",
                                                                                                                "hooks_count": 1,
                                                                                                                "download": {
                                                                                                                  "url": "https://github.example.com/api/v3/admin/pre-receive-environments/2/downloads/latest",
                                                                                                                  "state": "success",
                                                                                                                  "downloaded_at": "2016-05-26T07:42:53-05:00",
                                                                                                                  "message": null
                                                                                                                }
                                                                                                              },
                                                                                                              "allow_downstream_configuration": false
                                                                                                            }
                                                                                                          ]
                                                                                                          

                                                                                                          Create a pre-receive hook

                                                                                                          POST /admin/pre-receive-hooks
                                                                                                          

                                                                                                          Parameters

                                                                                                          Name Type Description
                                                                                                          name string Required The name of the hook.
                                                                                                          script string Required The script that the hook runs.
                                                                                                          script_repository object Required The GitHub repository where the script is kept.
                                                                                                          environment object Required The pre-receive environment where the script is executed.
                                                                                                          enforcement string The state of enforcement for this hook. default: disabled
                                                                                                          allow_downstream_configuration boolean Whether enforcement can be overridden at the org or repo level. default: false
                                                                                                          {
                                                                                                            "name": "Check Commits",
                                                                                                            "script": "scripts/commit_check.sh",
                                                                                                            "enforcement": "disabled",
                                                                                                            "allow_downstream_configuration": false,
                                                                                                            "script_repository": {
                                                                                                              "full_name": "DevIT/hooks"
                                                                                                            },
                                                                                                            "environment": {
                                                                                                              "id": 2
                                                                                                            }
                                                                                                          }
                                                                                                          

                                                                                                          Response

                                                                                                          Status: 201 Created
                                                                                                          
                                                                                                          {
                                                                                                            "id": 1,
                                                                                                            "name": "Check Commits",
                                                                                                            "enforcement": "disabled",
                                                                                                            "script": "scripts/commmit_check.sh",
                                                                                                            "script_repository": {
                                                                                                              "id": 595,
                                                                                                              "full_name": "DevIT/hooks",
                                                                                                              "url": "https://github.example.com/api/v3/repos/DevIT/hooks",
                                                                                                              "html_url": "https://github.example.com/DevIT/hooks"
                                                                                                            },
                                                                                                            "environment": {
                                                                                                              "id": 2,
                                                                                                              "name": "DevTools Hook Env",
                                                                                                              "image_url": "https://my_file_server/path/to/devtools_env.tar.gz",
                                                                                                              "url": "https://github.example.com/api/v3/admin/pre-receive-environments/2",
                                                                                                              "html_url": "https://github.example.com/admin/pre-receive-environments/2",
                                                                                                              "default_environment": false,
                                                                                                              "created_at": "2016-05-20T11:35:45-05:00",
                                                                                                              "hooks_count": 1,
                                                                                                              "download": {
                                                                                                                "url": "https://github.example.com/api/v3/admin/pre-receive-environments/2/downloads/latest",
                                                                                                                "state": "success",
                                                                                                                "downloaded_at": "2016-05-26T07:42:53-05:00",
                                                                                                                "message": null
                                                                                                              }
                                                                                                            },
                                                                                                            "allow_downstream_configuration": false
                                                                                                          }
                                                                                                          

                                                                                                          Edit a pre-receive hook

                                                                                                          PATCH /admin/pre_receive_hooks/:id
                                                                                                          
                                                                                                          {
                                                                                                            "name": "Check Commits",
                                                                                                            "environment": {
                                                                                                              "id": 1
                                                                                                            },
                                                                                                            "allow_downstream_configuration": true
                                                                                                          }
                                                                                                          

                                                                                                          Response

                                                                                                          Status: 200 OK
                                                                                                          
                                                                                                          {
                                                                                                            "id": 1,
                                                                                                            "name": "Check Commits",
                                                                                                            "enforcement": "disabled",
                                                                                                            "script": "scripts/commmit_check.sh",
                                                                                                            "script_repository": {
                                                                                                              "id": 595,
                                                                                                              "full_name": "DevIT/hooks",
                                                                                                              "url": "https://github.example.com/api/v3/repos/DevIT/hooks",
                                                                                                              "html_url": "https://github.example.com/DevIT/hooks"
                                                                                                            },
                                                                                                            "environment": {
                                                                                                              "id": 1,
                                                                                                              "name": "Default",
                                                                                                              "image_url": "githubenterprise://internal",
                                                                                                              "url": "https://github.example.com/api/v3/admin/pre-receive-environments/1",
                                                                                                              "html_url": "https://github.example.com/admin/pre-receive-environments/1",
                                                                                                              "default_environment": true,
                                                                                                              "created_at": "2016-05-20T11:35:45-05:00",
                                                                                                              "hooks_count": 1,
                                                                                                              "download": {
                                                                                                                "url": "https://github.example.com/api/v3/admin/pre-receive-environments/1/downloads/latest",
                                                                                                                "state": "success",
                                                                                                                "downloaded_at": "2016-05-26T07:42:53-05:00",
                                                                                                                "message": null
                                                                                                              }
                                                                                                            },
                                                                                                            "allow_downstream_configuration": true
                                                                                                          }
                                                                                                          

                                                                                                          Delete a pre-receive hook

                                                                                                          DELETE /admin/pre_receive_hooks/:id
                                                                                                          

                                                                                                          Response

                                                                                                          Status: 204 No Content
                                                                                                          
                                                                                                          tmp/developer.github.com/v3/enterprise-admin/search_indexing/index.html Search Indexing | GitHub Developer Guide

                                                                                                          Search Indexing

                                                                                                          The Search Indexing API allows you to queue up a variety of search indexing tasks. It is only available to authenticated site administrators. Normal users will receive a 404 response if they try to access it.

                                                                                                          Prefix all the endpoints for this API with the following URL:

                                                                                                          http(s)://hostname/api/v3
                                                                                                          

                                                                                                          Queue an indexing job

                                                                                                          POST /staff/indexing_jobs
                                                                                                          

                                                                                                          Input

                                                                                                          Name Type Description
                                                                                                          target string Required. A string representing the item to index.

                                                                                                          You can index the following targets (replace :owner with the name of a user or organization account and :repository with the name of a repository):

                                                                                                          Target Description
                                                                                                          :owner A user or organization account.
                                                                                                          :owner/:repository A repository.
                                                                                                          :owner/* All of a user or organization's repositories.
                                                                                                          :owner/:repository/issues All the issues in a repository.
                                                                                                          :owner/*/issues All the issues in all of a user or organization's repositories.
                                                                                                          :owner/:repository/code All the source code in a repository.
                                                                                                          :owner/*/code All the source code in all of a user or organization's repositories.

                                                                                                          Example

                                                                                                          curl -u jwatson -X POST -H "Content-Type: application/json" -d '{"target": "kansaichris/japaning"}' "http://hostname/api/v3/staff/indexing_jobs"
                                                                                                          

                                                                                                          Response

                                                                                                          Status: 202 Accepted
                                                                                                          
                                                                                                          {
                                                                                                            "message": "Repository 'kansaichris/japaning' has been added to the indexing queue"
                                                                                                          }
                                                                                                          
                                                                                                          tmp/developer.github.com/v3/gists/index.html Gists | GitHub Developer Guide

                                                                                                          Gists

                                                                                                          Note: To help with migrating from our REST API v3 to GraphQL API v4, we're introducing a preview period to include the GraphQL node_id in the response for many REST API v3 resources. See the blog post for full details. To access node_id during the preview period, you must provide a custom media type in the Accept header:

                                                                                                          application/vnd.github.jean-grey-preview+json
                                                                                                          

                                                                                                          Warning: The API may change without advance notice during the preview period. Preview features are not supported for production use. If you experience any issues, contact GitHub support.

                                                                                                          Authentication

                                                                                                          You can read public gists and create them for anonymous users without a token; however, to read or write gists on a user's behalf the gist OAuth scope is required.

                                                                                                          Truncation

                                                                                                          The Gist API provides up to one megabyte of content for each file in the gist. Each file returned for a gist through the API has a key called truncated. If truncated is true, the file is too large and only a portion of the contents were returned in content.

                                                                                                          If you need the full contents of the file, you can make a GET request to the URL specified by raw_url. Be aware that for files larger than ten megabytes, you'll need to clone the gist via the URL provided by git_pull_url.

                                                                                                          In addition to a specific file's contents being truncated, the entire files list may be truncated if the total number exceeds 300 files. If the top level truncated key is true, only the first 300 files have been returned in the files list. If you need to fetch all of the gist's files, you'll need to clone the gist via the URL provided by git_pull_url.

                                                                                                          List a user's gists

                                                                                                          List public gists for the specified user:

                                                                                                          GET /users/:username/gists
                                                                                                          

                                                                                                          List the authenticated user's gists or if called anonymously, this will return all public gists:

                                                                                                          GET /gists
                                                                                                          

                                                                                                          Parameters

                                                                                                          Name Type Description
                                                                                                          since string A timestamp in ISO 8601 format: YYYY-MM-DDTHH:MM:SSZ. Only gists updated at or after this time are returned.

                                                                                                          Response

                                                                                                          Status: 200 OK
                                                                                                          Link: <https://api.github.com/resource?page=2>; rel="next",
                                                                                                                <https://api.github.com/resource?page=5>; rel="last"
                                                                                                          
                                                                                                          [
                                                                                                            {
                                                                                                              "url": "https://api.github.com/gists/aa5a315d61ae9438b18d",
                                                                                                              "forks_url": "https://api.github.com/gists/aa5a315d61ae9438b18d/forks",
                                                                                                              "commits_url": "https://api.github.com/gists/aa5a315d61ae9438b18d/commits",
                                                                                                              "id": "aa5a315d61ae9438b18d",
                                                                                                              "description": "description of gist",
                                                                                                              "public": true,
                                                                                                              "owner": {
                                                                                                                "login": "octocat",
                                                                                                                "id": 1,
                                                                                                                "avatar_url": "https://github.com/images/error/octocat_happy.gif",
                                                                                                                "gravatar_id": "",
                                                                                                                "url": "https://api.github.com/users/octocat",
                                                                                                                "html_url": "https://github.com/octocat",
                                                                                                                "followers_url": "https://api.github.com/users/octocat/followers",
                                                                                                                "following_url": "https://api.github.com/users/octocat/following{/other_user}",
                                                                                                                "gists_url": "https://api.github.com/users/octocat/gists{/gist_id}",
                                                                                                                "starred_url": "https://api.github.com/users/octocat/starred{/owner}{/repo}",
                                                                                                                "subscriptions_url": "https://api.github.com/users/octocat/subscriptions",
                                                                                                                "organizations_url": "https://api.github.com/users/octocat/orgs",
                                                                                                                "repos_url": "https://api.github.com/users/octocat/repos",
                                                                                                                "events_url": "https://api.github.com/users/octocat/events{/privacy}",
                                                                                                                "received_events_url": "https://api.github.com/users/octocat/received_events",
                                                                                                                "type": "User",
                                                                                                                "site_admin": false
                                                                                                              },
                                                                                                              "user": null,
                                                                                                              "files": {
                                                                                                                "ring.erl": {
                                                                                                                  "size": 932,
                                                                                                                  "raw_url": "https://gist.githubusercontent.com/raw/365370/8c4d2d43d178df44f4c03a7f2ac0ff512853564e/ring.erl",
                                                                                                                  "type": "text/plain",
                                                                                                                  "truncated": false,
                                                                                                                  "language": "Erlang"
                                                                                                                }
                                                                                                              },
                                                                                                              "truncated": false,
                                                                                                              "comments": 0,
                                                                                                              "comments_url": "https://api.github.com/gists/aa5a315d61ae9438b18d/comments/",
                                                                                                              "html_url": "https://gist.github.com/aa5a315d61ae9438b18d",
                                                                                                              "git_pull_url": "https://gist.github.com/aa5a315d61ae9438b18d.git",
                                                                                                              "git_push_url": "https://gist.github.com/aa5a315d61ae9438b18d.git",
                                                                                                              "created_at": "2010-04-14T02:15:15Z",
                                                                                                              "updated_at": "2011-06-20T11:34:15Z"
                                                                                                            }
                                                                                                          ]
                                                                                                          

                                                                                                          List all public gists

                                                                                                          List all public gists sorted by most recently updated to least recently updated.

                                                                                                          Note: With pagination, you can fetch up to 3000 gists. For example, you can fetch 100 pages with 30 gists per page or 30 pages with 100 gists per page.

                                                                                                          GET /gists/public
                                                                                                          

                                                                                                          Parameters

                                                                                                          Name Type Description
                                                                                                          since string A timestamp in ISO 8601 format: YYYY-MM-DDTHH:MM:SSZ. Only gists updated at or after this time are returned.

                                                                                                          Response

                                                                                                          Status: 200 OK
                                                                                                          Link: <https://api.github.com/resource?page=2>; rel="next",
                                                                                                                <https://api.github.com/resource?page=5>; rel="last"
                                                                                                          
                                                                                                          [
                                                                                                            {
                                                                                                              "url": "https://api.github.com/gists/aa5a315d61ae9438b18d",
                                                                                                              "forks_url": "https://api.github.com/gists/aa5a315d61ae9438b18d/forks",
                                                                                                              "commits_url": "https://api.github.com/gists/aa5a315d61ae9438b18d/commits",
                                                                                                              "id": "aa5a315d61ae9438b18d",
                                                                                                              "description": "description of gist",
                                                                                                              "public": true,
                                                                                                              "owner": {
                                                                                                                "login": "octocat",
                                                                                                                "id": 1,
                                                                                                                "avatar_url": "https://github.com/images/error/octocat_happy.gif",
                                                                                                                "gravatar_id": "",
                                                                                                                "url": "https://api.github.com/users/octocat",
                                                                                                                "html_url": "https://github.com/octocat",
                                                                                                                "followers_url": "https://api.github.com/users/octocat/followers",
                                                                                                                "following_url": "https://api.github.com/users/octocat/following{/other_user}",
                                                                                                                "gists_url": "https://api.github.com/users/octocat/gists{/gist_id}",
                                                                                                                "starred_url": "https://api.github.com/users/octocat/starred{/owner}{/repo}",
                                                                                                                "subscriptions_url": "https://api.github.com/users/octocat/subscriptions",
                                                                                                                "organizations_url": "https://api.github.com/users/octocat/orgs",
                                                                                                                "repos_url": "https://api.github.com/users/octocat/repos",
                                                                                                                "events_url": "https://api.github.com/users/octocat/events{/privacy}",
                                                                                                                "received_events_url": "https://api.github.com/users/octocat/received_events",
                                                                                                                "type": "User",
                                                                                                                "site_admin": false
                                                                                                              },
                                                                                                              "user": null,
                                                                                                              "files": {
                                                                                                                "ring.erl": {
                                                                                                                  "size": 932,
                                                                                                                  "raw_url": "https://gist.githubusercontent.com/raw/365370/8c4d2d43d178df44f4c03a7f2ac0ff512853564e/ring.erl",
                                                                                                                  "type": "text/plain",
                                                                                                                  "truncated": false,
                                                                                                                  "language": "Erlang"
                                                                                                                }
                                                                                                              },
                                                                                                              "truncated": false,
                                                                                                              "comments": 0,
                                                                                                              "comments_url": "https://api.github.com/gists/aa5a315d61ae9438b18d/comments/",
                                                                                                              "html_url": "https://gist.github.com/aa5a315d61ae9438b18d",
                                                                                                              "git_pull_url": "https://gist.github.com/aa5a315d61ae9438b18d.git",
                                                                                                              "git_push_url": "https://gist.github.com/aa5a315d61ae9438b18d.git",
                                                                                                              "created_at": "2010-04-14T02:15:15Z",
                                                                                                              "updated_at": "2011-06-20T11:34:15Z"
                                                                                                            }
                                                                                                          ]
                                                                                                          

                                                                                                          List starred gists

                                                                                                          List the authenticated user's starred gists:

                                                                                                          GET /gists/starred
                                                                                                          

                                                                                                          Parameters

                                                                                                          Name Type Description
                                                                                                          since string A timestamp in ISO 8601 format: YYYY-MM-DDTHH:MM:SSZ. Only gists updated at or after this time are returned.

                                                                                                          Response

                                                                                                          Status: 200 OK
                                                                                                          Link: <https://api.github.com/resource?page=2>; rel="next",
                                                                                                                <https://api.github.com/resource?page=5>; rel="last"
                                                                                                          
                                                                                                          [
                                                                                                            {
                                                                                                              "url": "https://api.github.com/gists/aa5a315d61ae9438b18d",
                                                                                                              "forks_url": "https://api.github.com/gists/aa5a315d61ae9438b18d/forks",
                                                                                                              "commits_url": "https://api.github.com/gists/aa5a315d61ae9438b18d/commits",
                                                                                                              "id": "aa5a315d61ae9438b18d",
                                                                                                              "description": "description of gist",
                                                                                                              "public": true,
                                                                                                              "owner": {
                                                                                                                "login": "octocat",
                                                                                                                "id": 1,
                                                                                                                "avatar_url": "https://github.com/images/error/octocat_happy.gif",
                                                                                                                "gravatar_id": "",
                                                                                                                "url": "https://api.github.com/users/octocat",
                                                                                                                "html_url": "https://github.com/octocat",
                                                                                                                "followers_url": "https://api.github.com/users/octocat/followers",
                                                                                                                "following_url": "https://api.github.com/users/octocat/following{/other_user}",
                                                                                                                "gists_url": "https://api.github.com/users/octocat/gists{/gist_id}",
                                                                                                                "starred_url": "https://api.github.com/users/octocat/starred{/owner}{/repo}",
                                                                                                                "subscriptions_url": "https://api.github.com/users/octocat/subscriptions",
                                                                                                                "organizations_url": "https://api.github.com/users/octocat/orgs",
                                                                                                                "repos_url": "https://api.github.com/users/octocat/repos",
                                                                                                                "events_url": "https://api.github.com/users/octocat/events{/privacy}",
                                                                                                                "received_events_url": "https://api.github.com/users/octocat/received_events",
                                                                                                                "type": "User",
                                                                                                                "site_admin": false
                                                                                                              },
                                                                                                              "user": null,
                                                                                                              "files": {
                                                                                                                "ring.erl": {
                                                                                                                  "size": 932,
                                                                                                                  "raw_url": "https://gist.githubusercontent.com/raw/365370/8c4d2d43d178df44f4c03a7f2ac0ff512853564e/ring.erl",
                                                                                                                  "type": "text/plain",
                                                                                                                  "truncated": false,
                                                                                                                  "language": "Erlang"
                                                                                                                }
                                                                                                              },
                                                                                                              "truncated": false,
                                                                                                              "comments": 0,
                                                                                                              "comments_url": "https://api.github.com/gists/aa5a315d61ae9438b18d/comments/",
                                                                                                              "html_url": "https://gist.github.com/aa5a315d61ae9438b18d",
                                                                                                              "git_pull_url": "https://gist.github.com/aa5a315d61ae9438b18d.git",
                                                                                                              "git_push_url": "https://gist.github.com/aa5a315d61ae9438b18d.git",
                                                                                                              "created_at": "2010-04-14T02:15:15Z",
                                                                                                              "updated_at": "2011-06-20T11:34:15Z"
                                                                                                            }
                                                                                                          ]
                                                                                                          

                                                                                                          Get a single gist

                                                                                                          GET /gists/:id
                                                                                                          

                                                                                                          Response

                                                                                                          Status: 200 OK
                                                                                                          
                                                                                                          {
                                                                                                            "url": "https://api.github.com/gists/aa5a315d61ae9438b18d",
                                                                                                            "forks_url": "https://api.github.com/gists/aa5a315d61ae9438b18d/forks",
                                                                                                            "commits_url": "https://api.github.com/gists/aa5a315d61ae9438b18d/commits",
                                                                                                            "id": "aa5a315d61ae9438b18d",
                                                                                                            "description": "description of gist",
                                                                                                            "public": true,
                                                                                                            "owner": {
                                                                                                              "login": "octocat",
                                                                                                              "id": 1,
                                                                                                              "avatar_url": "https://github.com/images/error/octocat_happy.gif",
                                                                                                              "gravatar_id": "",
                                                                                                              "url": "https://api.github.com/users/octocat",
                                                                                                              "html_url": "https://github.com/octocat",
                                                                                                              "followers_url": "https://api.github.com/users/octocat/followers",
                                                                                                              "following_url": "https://api.github.com/users/octocat/following{/other_user}",
                                                                                                              "gists_url": "https://api.github.com/users/octocat/gists{/gist_id}",
                                                                                                              "starred_url": "https://api.github.com/users/octocat/starred{/owner}{/repo}",
                                                                                                              "subscriptions_url": "https://api.github.com/users/octocat/subscriptions",
                                                                                                              "organizations_url": "https://api.github.com/users/octocat/orgs",
                                                                                                              "repos_url": "https://api.github.com/users/octocat/repos",
                                                                                                              "events_url": "https://api.github.com/users/octocat/events{/privacy}",
                                                                                                              "received_events_url": "https://api.github.com/users/octocat/received_events",
                                                                                                              "type": "User",
                                                                                                              "site_admin": false
                                                                                                            },
                                                                                                            "user": null,
                                                                                                            "files": {
                                                                                                              "ring.erl": {
                                                                                                                "size": 932,
                                                                                                                "raw_url": "https://gist.githubusercontent.com/raw/365370/8c4d2d43d178df44f4c03a7f2ac0ff512853564e/ring.erl",
                                                                                                                "type": "text/plain",
                                                                                                                "language": "Erlang",
                                                                                                                "truncated": false,
                                                                                                                "content": "contents of gist"
                                                                                                              }
                                                                                                            },
                                                                                                            "truncated": false,
                                                                                                            "comments": 0,
                                                                                                            "comments_url": "https://api.github.com/gists/aa5a315d61ae9438b18d/comments/",
                                                                                                            "html_url": "https://gist.github.com/aa5a315d61ae9438b18d",
                                                                                                            "git_pull_url": "https://gist.github.com/aa5a315d61ae9438b18d.git",
                                                                                                            "git_push_url": "https://gist.github.com/aa5a315d61ae9438b18d.git",
                                                                                                            "created_at": "2010-04-14T02:15:15Z",
                                                                                                            "updated_at": "2011-06-20T11:34:15Z",
                                                                                                            "forks": [
                                                                                                              {
                                                                                                                "user": {
                                                                                                                  "login": "octocat",
                                                                                                                  "id": 1,
                                                                                                                  "avatar_url": "https://github.com/images/error/octocat_happy.gif",
                                                                                                                  "gravatar_id": "",
                                                                                                                  "url": "https://api.github.com/users/octocat",
                                                                                                                  "html_url": "https://github.com/octocat",
                                                                                                                  "followers_url": "https://api.github.com/users/octocat/followers",
                                                                                                                  "following_url": "https://api.github.com/users/octocat/following{/other_user}",
                                                                                                                  "gists_url": "https://api.github.com/users/octocat/gists{/gist_id}",
                                                                                                                  "starred_url": "https://api.github.com/users/octocat/starred{/owner}{/repo}",
                                                                                                                  "subscriptions_url": "https://api.github.com/users/octocat/subscriptions",
                                                                                                                  "organizations_url": "https://api.github.com/users/octocat/orgs",
                                                                                                                  "repos_url": "https://api.github.com/users/octocat/repos",
                                                                                                                  "events_url": "https://api.github.com/users/octocat/events{/privacy}",
                                                                                                                  "received_events_url": "https://api.github.com/users/octocat/received_events",
                                                                                                                  "type": "User",
                                                                                                                  "site_admin": false
                                                                                                                },
                                                                                                                "url": "https://api.github.com/gists/dee9c42e4998ce2ea439",
                                                                                                                "id": "dee9c42e4998ce2ea439",
                                                                                                                "created_at": "2011-04-14T16:00:49Z",
                                                                                                                "updated_at": "2011-04-14T16:00:49Z"
                                                                                                              }
                                                                                                            ],
                                                                                                            "history": [
                                                                                                              {
                                                                                                                "url": "https://api.github.com/gists/aa5a315d61ae9438b18d/57a7f021a713b1c5a6a199b54cc514735d2d462f",
                                                                                                                "version": "57a7f021a713b1c5a6a199b54cc514735d2d462f",
                                                                                                                "user": {
                                                                                                                  "login": "octocat",
                                                                                                                  "id": 1,
                                                                                                                  "avatar_url": "https://github.com/images/error/octocat_happy.gif",
                                                                                                                  "gravatar_id": "",
                                                                                                                  "url": "https://api.github.com/users/octocat",
                                                                                                                  "html_url": "https://github.com/octocat",
                                                                                                                  "followers_url": "https://api.github.com/users/octocat/followers",
                                                                                                                  "following_url": "https://api.github.com/users/octocat/following{/other_user}",
                                                                                                                  "gists_url": "https://api.github.com/users/octocat/gists{/gist_id}",
                                                                                                                  "starred_url": "https://api.github.com/users/octocat/starred{/owner}{/repo}",
                                                                                                                  "subscriptions_url": "https://api.github.com/users/octocat/subscriptions",
                                                                                                                  "organizations_url": "https://api.github.com/users/octocat/orgs",
                                                                                                                  "repos_url": "https://api.github.com/users/octocat/repos",
                                                                                                                  "events_url": "https://api.github.com/users/octocat/events{/privacy}",
                                                                                                                  "received_events_url": "https://api.github.com/users/octocat/received_events",
                                                                                                                  "type": "User",
                                                                                                                  "site_admin": false
                                                                                                                },
                                                                                                                "change_status": {
                                                                                                                  "deletions": 0,
                                                                                                                  "additions": 180,
                                                                                                                  "total": 180
                                                                                                                },
                                                                                                                "committed_at": "2010-04-14T02:15:15Z"
                                                                                                              }
                                                                                                            ]
                                                                                                          }
                                                                                                          

                                                                                                          Get a specific revision of a gist

                                                                                                          GET /gists/:id/:sha
                                                                                                          

                                                                                                          Response

                                                                                                          Status: 200 OK
                                                                                                          
                                                                                                          {
                                                                                                            "url": "https://api.github.com/gists/aa5a315d61ae9438b18d/57a7f021a713b1c5a6a199b54cc514735d2d462f",
                                                                                                            "forks_url": "https://api.github.com/gists/aa5a315d61ae9438b18d/forks",
                                                                                                            "commits_url": "https://api.github.com/gists/aa5a315d61ae9438b18d/commits",
                                                                                                            "id": "aa5a315d61ae9438b18d",
                                                                                                            "description": "description of gist",
                                                                                                            "public": true,
                                                                                                            "owner": {
                                                                                                              "login": "octocat",
                                                                                                              "id": 1,
                                                                                                              "avatar_url": "https://github.com/images/error/octocat_happy.gif",
                                                                                                              "gravatar_id": "",
                                                                                                              "url": "https://api.github.com/users/octocat",
                                                                                                              "html_url": "https://github.com/octocat",
                                                                                                              "followers_url": "https://api.github.com/users/octocat/followers",
                                                                                                              "following_url": "https://api.github.com/users/octocat/following{/other_user}",
                                                                                                              "gists_url": "https://api.github.com/users/octocat/gists{/gist_id}",
                                                                                                              "starred_url": "https://api.github.com/users/octocat/starred{/owner}{/repo}",
                                                                                                              "subscriptions_url": "https://api.github.com/users/octocat/subscriptions",
                                                                                                              "organizations_url": "https://api.github.com/users/octocat/orgs",
                                                                                                              "repos_url": "https://api.github.com/users/octocat/repos",
                                                                                                              "events_url": "https://api.github.com/users/octocat/events{/privacy}",
                                                                                                              "received_events_url": "https://api.github.com/users/octocat/received_events",
                                                                                                              "type": "User",
                                                                                                              "site_admin": false
                                                                                                            },
                                                                                                            "user": null,
                                                                                                            "files": {
                                                                                                              "ring.erl": {
                                                                                                                "size": 932,
                                                                                                                "raw_url": "https://gist.githubusercontent.com/raw/365370/8c4d2d43d178df44f4c03a7f2ac0ff512853564e/ring.erl",
                                                                                                                "type": "text/plain",
                                                                                                                "language": "Erlang",
                                                                                                                "truncated": false,
                                                                                                                "content": "contents of gist"
                                                                                                              }
                                                                                                            },
                                                                                                            "truncated": false,
                                                                                                            "comments": 0,
                                                                                                            "comments_url": "https://api.github.com/gists/aa5a315d61ae9438b18d/comments/",
                                                                                                            "html_url": "https://gist.github.com/aa5a315d61ae9438b18d",
                                                                                                            "git_pull_url": "https://gist.github.com/aa5a315d61ae9438b18d.git",
                                                                                                            "git_push_url": "https://gist.github.com/aa5a315d61ae9438b18d.git",
                                                                                                            "created_at": "2010-04-14T02:15:15Z",
                                                                                                            "updated_at": "2011-06-20T11:34:15Z",
                                                                                                            "forks": [
                                                                                                              {
                                                                                                                "user": {
                                                                                                                  "login": "octocat",
                                                                                                                  "id": 1,
                                                                                                                  "avatar_url": "https://github.com/images/error/octocat_happy.gif",
                                                                                                                  "gravatar_id": "",
                                                                                                                  "url": "https://api.github.com/users/octocat",
                                                                                                                  "html_url": "https://github.com/octocat",
                                                                                                                  "followers_url": "https://api.github.com/users/octocat/followers",
                                                                                                                  "following_url": "https://api.github.com/users/octocat/following{/other_user}",
                                                                                                                  "gists_url": "https://api.github.com/users/octocat/gists{/gist_id}",
                                                                                                                  "starred_url": "https://api.github.com/users/octocat/starred{/owner}{/repo}",
                                                                                                                  "subscriptions_url": "https://api.github.com/users/octocat/subscriptions",
                                                                                                                  "organizations_url": "https://api.github.com/users/octocat/orgs",
                                                                                                                  "repos_url": "https://api.github.com/users/octocat/repos",
                                                                                                                  "events_url": "https://api.github.com/users/octocat/events{/privacy}",
                                                                                                                  "received_events_url": "https://api.github.com/users/octocat/received_events",
                                                                                                                  "type": "User",
                                                                                                                  "site_admin": false
                                                                                                                },
                                                                                                                "url": "https://api.github.com/gists/dee9c42e4998ce2ea439",
                                                                                                                "id": "dee9c42e4998ce2ea439",
                                                                                                                "created_at": "2011-04-14T16:00:49Z",
                                                                                                                "updated_at": "2011-04-14T16:00:49Z"
                                                                                                              }
                                                                                                            ],
                                                                                                            "history": [
                                                                                                              {
                                                                                                                "url": "https://api.github.com/gists/aa5a315d61ae9438b18d/57a7f021a713b1c5a6a199b54cc514735d2d462f",
                                                                                                                "version": "57a7f021a713b1c5a6a199b54cc514735d2d462f",
                                                                                                                "user": {
                                                                                                                  "login": "octocat",
                                                                                                                  "id": 1,
                                                                                                                  "avatar_url": "https://github.com/images/error/octocat_happy.gif",
                                                                                                                  "gravatar_id": "",
                                                                                                                  "url": "https://api.github.com/users/octocat",
                                                                                                                  "html_url": "https://github.com/octocat",
                                                                                                                  "followers_url": "https://api.github.com/users/octocat/followers",
                                                                                                                  "following_url": "https://api.github.com/users/octocat/following{/other_user}",
                                                                                                                  "gists_url": "https://api.github.com/users/octocat/gists{/gist_id}",
                                                                                                                  "starred_url": "https://api.github.com/users/octocat/starred{/owner}{/repo}",
                                                                                                                  "subscriptions_url": "https://api.github.com/users/octocat/subscriptions",
                                                                                                                  "organizations_url": "https://api.github.com/users/octocat/orgs",
                                                                                                                  "repos_url": "https://api.github.com/users/octocat/repos",
                                                                                                                  "events_url": "https://api.github.com/users/octocat/events{/privacy}",
                                                                                                                  "received_events_url": "https://api.github.com/users/octocat/received_events",
                                                                                                                  "type": "User",
                                                                                                                  "site_admin": false
                                                                                                                },
                                                                                                                "change_status": {
                                                                                                                  "deletions": 0,
                                                                                                                  "additions": 180,
                                                                                                                  "total": 180
                                                                                                                },
                                                                                                                "committed_at": "2010-04-14T02:15:15Z"
                                                                                                              }
                                                                                                            ]
                                                                                                          }
                                                                                                          

                                                                                                          Create a gist

                                                                                                          POST /gists
                                                                                                          

                                                                                                          Input

                                                                                                          Name Type Description
                                                                                                          files object Required. Files that make up this gist.
                                                                                                          description string A description of the gist.
                                                                                                          public boolean Indicates whether the gist is public. Default: false

                                                                                                          The keys in the files object are the string filename, and the value is another object with a key of content, and a value of the file contents. For example:

                                                                                                          {
                                                                                                            "description": "the description for this gist",
                                                                                                            "public": true,
                                                                                                            "files": {
                                                                                                              "file1.txt": {
                                                                                                                "content": "String file contents"
                                                                                                              }
                                                                                                            }
                                                                                                          }
                                                                                                          

                                                                                                          Note: Don't name your files "gistfile" with a numerical suffix. This is the format of the automatic naming scheme that Gist uses internally.

                                                                                                          Response

                                                                                                          Status: 201 Created
                                                                                                          Location: https://api.github.com/gists/aa5a315d61ae9438b18d
                                                                                                          
                                                                                                          {
                                                                                                            "url": "https://api.github.com/gists/aa5a315d61ae9438b18d",
                                                                                                            "forks_url": "https://api.github.com/gists/aa5a315d61ae9438b18d/forks",
                                                                                                            "commits_url": "https://api.github.com/gists/aa5a315d61ae9438b18d/commits",
                                                                                                            "id": "aa5a315d61ae9438b18d",
                                                                                                            "description": "description of gist",
                                                                                                            "public": true,
                                                                                                            "owner": {
                                                                                                              "login": "octocat",
                                                                                                              "id": 1,
                                                                                                              "avatar_url": "https://github.com/images/error/octocat_happy.gif",
                                                                                                              "gravatar_id": "",
                                                                                                              "url": "https://api.github.com/users/octocat",
                                                                                                              "html_url": "https://github.com/octocat",
                                                                                                              "followers_url": "https://api.github.com/users/octocat/followers",
                                                                                                              "following_url": "https://api.github.com/users/octocat/following{/other_user}",
                                                                                                              "gists_url": "https://api.github.com/users/octocat/gists{/gist_id}",
                                                                                                              "starred_url": "https://api.github.com/users/octocat/starred{/owner}{/repo}",
                                                                                                              "subscriptions_url": "https://api.github.com/users/octocat/subscriptions",
                                                                                                              "organizations_url": "https://api.github.com/users/octocat/orgs",
                                                                                                              "repos_url": "https://api.github.com/users/octocat/repos",
                                                                                                              "events_url": "https://api.github.com/users/octocat/events{/privacy}",
                                                                                                              "received_events_url": "https://api.github.com/users/octocat/received_events",
                                                                                                              "type": "User",
                                                                                                              "site_admin": false
                                                                                                            },
                                                                                                            "user": null,
                                                                                                            "files": {
                                                                                                              "ring.erl": {
                                                                                                                "size": 932,
                                                                                                                "raw_url": "https://gist.githubusercontent.com/raw/365370/8c4d2d43d178df44f4c03a7f2ac0ff512853564e/ring.erl",
                                                                                                                "type": "text/plain",
                                                                                                                "language": "Erlang",
                                                                                                                "truncated": false,
                                                                                                                "content": "contents of gist"
                                                                                                              }
                                                                                                            },
                                                                                                            "truncated": false,
                                                                                                            "comments": 0,
                                                                                                            "comments_url": "https://api.github.com/gists/aa5a315d61ae9438b18d/comments/",
                                                                                                            "html_url": "https://gist.github.com/aa5a315d61ae9438b18d",
                                                                                                            "git_pull_url": "https://gist.github.com/aa5a315d61ae9438b18d.git",
                                                                                                            "git_push_url": "https://gist.github.com/aa5a315d61ae9438b18d.git",
                                                                                                            "created_at": "2010-04-14T02:15:15Z",
                                                                                                            "updated_at": "2011-06-20T11:34:15Z",
                                                                                                            "forks": [
                                                                                                              {
                                                                                                                "user": {
                                                                                                                  "login": "octocat",
                                                                                                                  "id": 1,
                                                                                                                  "avatar_url": "https://github.com/images/error/octocat_happy.gif",
                                                                                                                  "gravatar_id": "",
                                                                                                                  "url": "https://api.github.com/users/octocat",
                                                                                                                  "html_url": "https://github.com/octocat",
                                                                                                                  "followers_url": "https://api.github.com/users/octocat/followers",
                                                                                                                  "following_url": "https://api.github.com/users/octocat/following{/other_user}",
                                                                                                                  "gists_url": "https://api.github.com/users/octocat/gists{/gist_id}",
                                                                                                                  "starred_url": "https://api.github.com/users/octocat/starred{/owner}{/repo}",
                                                                                                                  "subscriptions_url": "https://api.github.com/users/octocat/subscriptions",
                                                                                                                  "organizations_url": "https://api.github.com/users/octocat/orgs",
                                                                                                                  "repos_url": "https://api.github.com/users/octocat/repos",
                                                                                                                  "events_url": "https://api.github.com/users/octocat/events{/privacy}",
                                                                                                                  "received_events_url": "https://api.github.com/users/octocat/received_events",
                                                                                                                  "type": "User",
                                                                                                                  "site_admin": false
                                                                                                                },
                                                                                                                "url": "https://api.github.com/gists/dee9c42e4998ce2ea439",
                                                                                                                "id": "dee9c42e4998ce2ea439",
                                                                                                                "created_at": "2011-04-14T16:00:49Z",
                                                                                                                "updated_at": "2011-04-14T16:00:49Z"
                                                                                                              }
                                                                                                            ],
                                                                                                            "history": [
                                                                                                              {
                                                                                                                "url": "https://api.github.com/gists/aa5a315d61ae9438b18d/57a7f021a713b1c5a6a199b54cc514735d2d462f",
                                                                                                                "version": "57a7f021a713b1c5a6a199b54cc514735d2d462f",
                                                                                                                "user": {
                                                                                                                  "login": "octocat",
                                                                                                                  "id": 1,
                                                                                                                  "avatar_url": "https://github.com/images/error/octocat_happy.gif",
                                                                                                                  "gravatar_id": "",
                                                                                                                  "url": "https://api.github.com/users/octocat",
                                                                                                                  "html_url": "https://github.com/octocat",
                                                                                                                  "followers_url": "https://api.github.com/users/octocat/followers",
                                                                                                                  "following_url": "https://api.github.com/users/octocat/following{/other_user}",
                                                                                                                  "gists_url": "https://api.github.com/users/octocat/gists{/gist_id}",
                                                                                                                  "starred_url": "https://api.github.com/users/octocat/starred{/owner}{/repo}",
                                                                                                                  "subscriptions_url": "https://api.github.com/users/octocat/subscriptions",
                                                                                                                  "organizations_url": "https://api.github.com/users/octocat/orgs",
                                                                                                                  "repos_url": "https://api.github.com/users/octocat/repos",
                                                                                                                  "events_url": "https://api.github.com/users/octocat/events{/privacy}",
                                                                                                                  "received_events_url": "https://api.github.com/users/octocat/received_events",
                                                                                                                  "type": "User",
                                                                                                                  "site_admin": false
                                                                                                                },
                                                                                                                "change_status": {
                                                                                                                  "deletions": 0,
                                                                                                                  "additions": 180,
                                                                                                                  "total": 180
                                                                                                                },
                                                                                                                "committed_at": "2010-04-14T02:15:15Z"
                                                                                                              }
                                                                                                            ]
                                                                                                          }
                                                                                                          

                                                                                                          Edit a gist

                                                                                                          PATCH /gists/:id
                                                                                                          

                                                                                                          Input

                                                                                                          Name Type Description
                                                                                                          description string A description of the gist.
                                                                                                          files object Files that make up this gist.
                                                                                                          content string Updated file contents.
                                                                                                          filename string New name for this file.

                                                                                                          The keys in the files object are the string filename. The value is another object with a key of content (indicating the new contents), or filename (indicating the new filename). For example:

                                                                                                          {
                                                                                                            "description": "the description for this gist",
                                                                                                            "files": {
                                                                                                              "file1.txt": {
                                                                                                                "content": "updated file contents"
                                                                                                              },
                                                                                                              "old_name.txt": {
                                                                                                                "filename": "new_name.txt",
                                                                                                                "content": "modified contents"
                                                                                                              },
                                                                                                              "new_file.txt": {
                                                                                                                "content": "a new file"
                                                                                                              },
                                                                                                              "delete_this_file.txt": null
                                                                                                            }
                                                                                                          }
                                                                                                          

                                                                                                          Note: All files from the previous version of the gist are carried over by default if not included in the object. Deletes can be performed by including the filename with a null object.

                                                                                                          Response

                                                                                                          Status: 200 OK
                                                                                                          
                                                                                                          {
                                                                                                            "url": "https://api.github.com/gists/aa5a315d61ae9438b18d",
                                                                                                            "forks_url": "https://api.github.com/gists/aa5a315d61ae9438b18d/forks",
                                                                                                            "commits_url": "https://api.github.com/gists/aa5a315d61ae9438b18d/commits",
                                                                                                            "id": "aa5a315d61ae9438b18d",
                                                                                                            "description": "description of gist",
                                                                                                            "public": true,
                                                                                                            "owner": {
                                                                                                              "login": "octocat",
                                                                                                              "id": 1,
                                                                                                              "avatar_url": "https://github.com/images/error/octocat_happy.gif",
                                                                                                              "gravatar_id": "",
                                                                                                              "url": "https://api.github.com/users/octocat",
                                                                                                              "html_url": "https://github.com/octocat",
                                                                                                              "followers_url": "https://api.github.com/users/octocat/followers",
                                                                                                              "following_url": "https://api.github.com/users/octocat/following{/other_user}",
                                                                                                              "gists_url": "https://api.github.com/users/octocat/gists{/gist_id}",
                                                                                                              "starred_url": "https://api.github.com/users/octocat/starred{/owner}{/repo}",
                                                                                                              "subscriptions_url": "https://api.github.com/users/octocat/subscriptions",
                                                                                                              "organizations_url": "https://api.github.com/users/octocat/orgs",
                                                                                                              "repos_url": "https://api.github.com/users/octocat/repos",
                                                                                                              "events_url": "https://api.github.com/users/octocat/events{/privacy}",
                                                                                                              "received_events_url": "https://api.github.com/users/octocat/received_events",
                                                                                                              "type": "User",
                                                                                                              "site_admin": false
                                                                                                            },
                                                                                                            "user": null,
                                                                                                            "files": {
                                                                                                              "ring.erl": {
                                                                                                                "size": 932,
                                                                                                                "raw_url": "https://gist.githubusercontent.com/raw/365370/8c4d2d43d178df44f4c03a7f2ac0ff512853564e/ring.erl",
                                                                                                                "type": "text/plain",
                                                                                                                "language": "Erlang",
                                                                                                                "truncated": false,
                                                                                                                "content": "contents of gist"
                                                                                                              }
                                                                                                            },
                                                                                                            "truncated": false,
                                                                                                            "comments": 0,
                                                                                                            "comments_url": "https://api.github.com/gists/aa5a315d61ae9438b18d/comments/",
                                                                                                            "html_url": "https://gist.github.com/aa5a315d61ae9438b18d",
                                                                                                            "git_pull_url": "https://gist.github.com/aa5a315d61ae9438b18d.git",
                                                                                                            "git_push_url": "https://gist.github.com/aa5a315d61ae9438b18d.git",
                                                                                                            "created_at": "2010-04-14T02:15:15Z",
                                                                                                            "updated_at": "2011-06-20T11:34:15Z",
                                                                                                            "forks": [
                                                                                                              {
                                                                                                                "user": {
                                                                                                                  "login": "octocat",
                                                                                                                  "id": 1,
                                                                                                                  "avatar_url": "https://github.com/images/error/octocat_happy.gif",
                                                                                                                  "gravatar_id": "",
                                                                                                                  "url": "https://api.github.com/users/octocat",
                                                                                                                  "html_url": "https://github.com/octocat",
                                                                                                                  "followers_url": "https://api.github.com/users/octocat/followers",
                                                                                                                  "following_url": "https://api.github.com/users/octocat/following{/other_user}",
                                                                                                                  "gists_url": "https://api.github.com/users/octocat/gists{/gist_id}",
                                                                                                                  "starred_url": "https://api.github.com/users/octocat/starred{/owner}{/repo}",
                                                                                                                  "subscriptions_url": "https://api.github.com/users/octocat/subscriptions",
                                                                                                                  "organizations_url": "https://api.github.com/users/octocat/orgs",
                                                                                                                  "repos_url": "https://api.github.com/users/octocat/repos",
                                                                                                                  "events_url": "https://api.github.com/users/octocat/events{/privacy}",
                                                                                                                  "received_events_url": "https://api.github.com/users/octocat/received_events",
                                                                                                                  "type": "User",
                                                                                                                  "site_admin": false
                                                                                                                },
                                                                                                                "url": "https://api.github.com/gists/dee9c42e4998ce2ea439",
                                                                                                                "id": "dee9c42e4998ce2ea439",
                                                                                                                "created_at": "2011-04-14T16:00:49Z",
                                                                                                                "updated_at": "2011-04-14T16:00:49Z"
                                                                                                              }
                                                                                                            ],
                                                                                                            "history": [
                                                                                                              {
                                                                                                                "url": "https://api.github.com/gists/aa5a315d61ae9438b18d/57a7f021a713b1c5a6a199b54cc514735d2d462f",
                                                                                                                "version": "57a7f021a713b1c5a6a199b54cc514735d2d462f",
                                                                                                                "user": {
                                                                                                                  "login": "octocat",
                                                                                                                  "id": 1,
                                                                                                                  "avatar_url": "https://github.com/images/error/octocat_happy.gif",
                                                                                                                  "gravatar_id": "",
                                                                                                                  "url": "https://api.github.com/users/octocat",
                                                                                                                  "html_url": "https://github.com/octocat",
                                                                                                                  "followers_url": "https://api.github.com/users/octocat/followers",
                                                                                                                  "following_url": "https://api.github.com/users/octocat/following{/other_user}",
                                                                                                                  "gists_url": "https://api.github.com/users/octocat/gists{/gist_id}",
                                                                                                                  "starred_url": "https://api.github.com/users/octocat/starred{/owner}{/repo}",
                                                                                                                  "subscriptions_url": "https://api.github.com/users/octocat/subscriptions",
                                                                                                                  "organizations_url": "https://api.github.com/users/octocat/orgs",
                                                                                                                  "repos_url": "https://api.github.com/users/octocat/repos",
                                                                                                                  "events_url": "https://api.github.com/users/octocat/events{/privacy}",
                                                                                                                  "received_events_url": "https://api.github.com/users/octocat/received_events",
                                                                                                                  "type": "User",
                                                                                                                  "site_admin": false
                                                                                                                },
                                                                                                                "change_status": {
                                                                                                                  "deletions": 0,
                                                                                                                  "additions": 180,
                                                                                                                  "total": 180
                                                                                                                },
                                                                                                                "committed_at": "2010-04-14T02:15:15Z"
                                                                                                              }
                                                                                                            ]
                                                                                                          }
                                                                                                          

                                                                                                          List gist commits

                                                                                                          GET /gists/:id/commits
                                                                                                          

                                                                                                          Response

                                                                                                          Status: 200 OK
                                                                                                          Link: <https://api.github.com/resource?page=2>; rel="next"
                                                                                                          
                                                                                                          [
                                                                                                            {
                                                                                                              "url": "https://api.github.com/gists/aa5a315d61ae9438b18d/57a7f021a713b1c5a6a199b54cc514735d2d462f",
                                                                                                              "version": "57a7f021a713b1c5a6a199b54cc514735d2d462f",
                                                                                                              "user": {
                                                                                                                "login": "octocat",
                                                                                                                "id": 1,
                                                                                                                "avatar_url": "https://github.com/images/error/octocat_happy.gif",
                                                                                                                "gravatar_id": "",
                                                                                                                "url": "https://api.github.com/users/octocat",
                                                                                                                "html_url": "https://github.com/octocat",
                                                                                                                "followers_url": "https://api.github.com/users/octocat/followers",
                                                                                                                "following_url": "https://api.github.com/users/octocat/following{/other_user}",
                                                                                                                "gists_url": "https://api.github.com/users/octocat/gists{/gist_id}",
                                                                                                                "starred_url": "https://api.github.com/users/octocat/starred{/owner}{/repo}",
                                                                                                                "subscriptions_url": "https://api.github.com/users/octocat/subscriptions",
                                                                                                                "organizations_url": "https://api.github.com/users/octocat/orgs",
                                                                                                                "repos_url": "https://api.github.com/users/octocat/repos",
                                                                                                                "events_url": "https://api.github.com/users/octocat/events{/privacy}",
                                                                                                                "received_events_url": "https://api.github.com/users/octocat/received_events",
                                                                                                                "type": "User",
                                                                                                                "site_admin": false
                                                                                                              },
                                                                                                              "change_status": {
                                                                                                                "deletions": 0,
                                                                                                                "additions": 180,
                                                                                                                "total": 180
                                                                                                              },
                                                                                                              "committed_at": "2010-04-14T02:15:15Z"
                                                                                                            }
                                                                                                          ]
                                                                                                          

                                                                                                          Star a gist

                                                                                                          PUT /gists/:id/star
                                                                                                          

                                                                                                          Note that you'll need to set Content-Length to zero when calling out to this endpoint. For more information, see "HTTP verbs."

                                                                                                          Response

                                                                                                          Status: 204 No Content
                                                                                                          

                                                                                                          Unstar a gist

                                                                                                          DELETE /gists/:id/star
                                                                                                          

                                                                                                          Response

                                                                                                          Status: 204 No Content
                                                                                                          

                                                                                                          Check if a gist is starred

                                                                                                          GET /gists/:id/star
                                                                                                          

                                                                                                          Response if gist is starred

                                                                                                          Status: 204 No Content
                                                                                                          

                                                                                                          Response if gist is not starred

                                                                                                          Status: 404 Not Found
                                                                                                          

                                                                                                          Fork a gist

                                                                                                          POST /gists/:id/forks
                                                                                                          

                                                                                                          Note: This was previously /gists/:id/fork.

                                                                                                          Response

                                                                                                          Status: 201 Created
                                                                                                          Location: https://api.github.com/gists/aa5a315d61ae9438b18d
                                                                                                          
                                                                                                          {
                                                                                                            "url": "https://api.github.com/gists/aa5a315d61ae9438b18d",
                                                                                                            "forks_url": "https://api.github.com/gists/aa5a315d61ae9438b18d/forks",
                                                                                                            "commits_url": "https://api.github.com/gists/aa5a315d61ae9438b18d/commits",
                                                                                                            "id": "aa5a315d61ae9438b18d",
                                                                                                            "description": "description of gist",
                                                                                                            "public": true,
                                                                                                            "owner": {
                                                                                                              "login": "octocat",
                                                                                                              "id": 1,
                                                                                                              "avatar_url": "https://github.com/images/error/octocat_happy.gif",
                                                                                                              "gravatar_id": "",
                                                                                                              "url": "https://api.github.com/users/octocat",
                                                                                                              "html_url": "https://github.com/octocat",
                                                                                                              "followers_url": "https://api.github.com/users/octocat/followers",
                                                                                                              "following_url": "https://api.github.com/users/octocat/following{/other_user}",
                                                                                                              "gists_url": "https://api.github.com/users/octocat/gists{/gist_id}",
                                                                                                              "starred_url": "https://api.github.com/users/octocat/starred{/owner}{/repo}",
                                                                                                              "subscriptions_url": "https://api.github.com/users/octocat/subscriptions",
                                                                                                              "organizations_url": "https://api.github.com/users/octocat/orgs",
                                                                                                              "repos_url": "https://api.github.com/users/octocat/repos",
                                                                                                              "events_url": "https://api.github.com/users/octocat/events{/privacy}",
                                                                                                              "received_events_url": "https://api.github.com/users/octocat/received_events",
                                                                                                              "type": "User",
                                                                                                              "site_admin": false
                                                                                                            },
                                                                                                            "user": null,
                                                                                                            "files": {
                                                                                                              "ring.erl": {
                                                                                                                "size": 932,
                                                                                                                "raw_url": "https://gist.githubusercontent.com/raw/365370/8c4d2d43d178df44f4c03a7f2ac0ff512853564e/ring.erl",
                                                                                                                "type": "text/plain",
                                                                                                                "truncated": false,
                                                                                                                "language": "Erlang"
                                                                                                              }
                                                                                                            },
                                                                                                            "truncated": false,
                                                                                                            "comments": 0,
                                                                                                            "comments_url": "https://api.github.com/gists/aa5a315d61ae9438b18d/comments/",
                                                                                                            "html_url": "https://gist.github.com/aa5a315d61ae9438b18d",
                                                                                                            "git_pull_url": "https://gist.github.com/aa5a315d61ae9438b18d.git",
                                                                                                            "git_push_url": "https://gist.github.com/aa5a315d61ae9438b18d.git",
                                                                                                            "created_at": "2010-04-14T02:15:15Z",
                                                                                                            "updated_at": "2011-06-20T11:34:15Z"
                                                                                                          }
                                                                                                          

                                                                                                          List gist forks

                                                                                                          GET /gists/:id/forks
                                                                                                          

                                                                                                          Response

                                                                                                          Status: 200 OK
                                                                                                          Link: <https://api.github.com/resource?page=2>; rel="next",
                                                                                                                <https://api.github.com/resource?page=5>; rel="last"
                                                                                                          
                                                                                                          [
                                                                                                            {
                                                                                                              "user": {
                                                                                                                "login": "octocat",
                                                                                                                "id": 1,
                                                                                                                "avatar_url": "https://github.com/images/error/octocat_happy.gif",
                                                                                                                "gravatar_id": "",
                                                                                                                "url": "https://api.github.com/users/octocat",
                                                                                                                "html_url": "https://github.com/octocat",
                                                                                                                "followers_url": "https://api.github.com/users/octocat/followers",
                                                                                                                "following_url": "https://api.github.com/users/octocat/following{/other_user}",
                                                                                                                "gists_url": "https://api.github.com/users/octocat/gists{/gist_id}",
                                                                                                                "starred_url": "https://api.github.com/users/octocat/starred{/owner}{/repo}",
                                                                                                                "subscriptions_url": "https://api.github.com/users/octocat/subscriptions",
                                                                                                                "organizations_url": "https://api.github.com/users/octocat/orgs",
                                                                                                                "repos_url": "https://api.github.com/users/octocat/repos",
                                                                                                                "events_url": "https://api.github.com/users/octocat/events{/privacy}",
                                                                                                                "received_events_url": "https://api.github.com/users/octocat/received_events",
                                                                                                                "type": "User",
                                                                                                                "site_admin": false
                                                                                                              },
                                                                                                              "url": "https://api.github.com/gists/dee9c42e4998ce2ea439",
                                                                                                              "id": "dee9c42e4998ce2ea439",
                                                                                                              "created_at": "2011-04-14T16:00:49Z",
                                                                                                              "updated_at": "2011-04-14T16:00:49Z"
                                                                                                            }
                                                                                                          ]
                                                                                                          

                                                                                                          Delete a gist

                                                                                                          DELETE /gists/:id
                                                                                                          

                                                                                                          Response

                                                                                                          Status: 204 No Content
                                                                                                          

                                                                                                          Custom media types

                                                                                                          The following media types are supported when fetching gist contents. You can read more about the use of media types in the API here.

                                                                                                          application/vnd.github.VERSION.raw
                                                                                                          application/vnd.github.VERSION.base64
                                                                                                          
                                                                                                          tmp/developer.github.com/v3/gists/comments/index.html Gist Comments | GitHub Developer Guide

                                                                                                          Comments

                                                                                                          Gist Comments use these custom media types. You can read more about the use of media types in the API here.

                                                                                                          List comments on a gist

                                                                                                          GET /gists/:gist_id/comments
                                                                                                          

                                                                                                          Response

                                                                                                          Status: 200 OK
                                                                                                          Link: <https://api.github.com/resource?page=2>; rel="next",
                                                                                                                <https://api.github.com/resource?page=5>; rel="last"
                                                                                                          
                                                                                                          [
                                                                                                            {
                                                                                                              "id": 1,
                                                                                                              "url": "https://api.github.com/gists/a6db0bec360bb87e9418/comments/1",
                                                                                                              "body": "Just commenting for the sake of commenting",
                                                                                                              "user": {
                                                                                                                "login": "octocat",
                                                                                                                "id": 1,
                                                                                                                "avatar_url": "https://github.com/images/error/octocat_happy.gif",
                                                                                                                "gravatar_id": "",
                                                                                                                "url": "https://api.github.com/users/octocat",
                                                                                                                "html_url": "https://github.com/octocat",
                                                                                                                "followers_url": "https://api.github.com/users/octocat/followers",
                                                                                                                "following_url": "https://api.github.com/users/octocat/following{/other_user}",
                                                                                                                "gists_url": "https://api.github.com/users/octocat/gists{/gist_id}",
                                                                                                                "starred_url": "https://api.github.com/users/octocat/starred{/owner}{/repo}",
                                                                                                                "subscriptions_url": "https://api.github.com/users/octocat/subscriptions",
                                                                                                                "organizations_url": "https://api.github.com/users/octocat/orgs",
                                                                                                                "repos_url": "https://api.github.com/users/octocat/repos",
                                                                                                                "events_url": "https://api.github.com/users/octocat/events{/privacy}",
                                                                                                                "received_events_url": "https://api.github.com/users/octocat/received_events",
                                                                                                                "type": "User",
                                                                                                                "site_admin": false
                                                                                                              },
                                                                                                              "created_at": "2011-04-18T23:23:56Z",
                                                                                                              "updated_at": "2011-04-18T23:23:56Z"
                                                                                                            }
                                                                                                          ]
                                                                                                          

                                                                                                          Get a single comment

                                                                                                          GET /gists/:gist_id/comments/:id
                                                                                                          

                                                                                                          Response

                                                                                                          Status: 200 OK
                                                                                                          
                                                                                                          {
                                                                                                            "id": 1,
                                                                                                            "url": "https://api.github.com/gists/a6db0bec360bb87e9418/comments/1",
                                                                                                            "body": "Just commenting for the sake of commenting",
                                                                                                            "user": {
                                                                                                              "login": "octocat",
                                                                                                              "id": 1,
                                                                                                              "avatar_url": "https://github.com/images/error/octocat_happy.gif",
                                                                                                              "gravatar_id": "",
                                                                                                              "url": "https://api.github.com/users/octocat",
                                                                                                              "html_url": "https://github.com/octocat",
                                                                                                              "followers_url": "https://api.github.com/users/octocat/followers",
                                                                                                              "following_url": "https://api.github.com/users/octocat/following{/other_user}",
                                                                                                              "gists_url": "https://api.github.com/users/octocat/gists{/gist_id}",
                                                                                                              "starred_url": "https://api.github.com/users/octocat/starred{/owner}{/repo}",
                                                                                                              "subscriptions_url": "https://api.github.com/users/octocat/subscriptions",
                                                                                                              "organizations_url": "https://api.github.com/users/octocat/orgs",
                                                                                                              "repos_url": "https://api.github.com/users/octocat/repos",
                                                                                                              "events_url": "https://api.github.com/users/octocat/events{/privacy}",
                                                                                                              "received_events_url": "https://api.github.com/users/octocat/received_events",
                                                                                                              "type": "User",
                                                                                                              "site_admin": false
                                                                                                            },
                                                                                                            "created_at": "2011-04-18T23:23:56Z",
                                                                                                            "updated_at": "2011-04-18T23:23:56Z"
                                                                                                          }
                                                                                                          

                                                                                                          Create a comment

                                                                                                          POST /gists/:gist_id/comments
                                                                                                          

                                                                                                          Parameters

                                                                                                          Name Type Description
                                                                                                          body string Required. The comment text.
                                                                                                          {
                                                                                                            "body": "Just commenting for the sake of commenting"
                                                                                                          }
                                                                                                          

                                                                                                          Response

                                                                                                          Status: 201 Created
                                                                                                          Location: https://api.github.com/gists/a6db0bec360bb87e9418/comments/1
                                                                                                          
                                                                                                          {
                                                                                                            "id": 1,
                                                                                                            "url": "https://api.github.com/gists/a6db0bec360bb87e9418/comments/1",
                                                                                                            "body": "Just commenting for the sake of commenting",
                                                                                                            "user": {
                                                                                                              "login": "octocat",
                                                                                                              "id": 1,
                                                                                                              "avatar_url": "https://github.com/images/error/octocat_happy.gif",
                                                                                                              "gravatar_id": "",
                                                                                                              "url": "https://api.github.com/users/octocat",
                                                                                                              "html_url": "https://github.com/octocat",
                                                                                                              "followers_url": "https://api.github.com/users/octocat/followers",
                                                                                                              "following_url": "https://api.github.com/users/octocat/following{/other_user}",
                                                                                                              "gists_url": "https://api.github.com/users/octocat/gists{/gist_id}",
                                                                                                              "starred_url": "https://api.github.com/users/octocat/starred{/owner}{/repo}",
                                                                                                              "subscriptions_url": "https://api.github.com/users/octocat/subscriptions",
                                                                                                              "organizations_url": "https://api.github.com/users/octocat/orgs",
                                                                                                              "repos_url": "https://api.github.com/users/octocat/repos",
                                                                                                              "events_url": "https://api.github.com/users/octocat/events{/privacy}",
                                                                                                              "received_events_url": "https://api.github.com/users/octocat/received_events",
                                                                                                              "type": "User",
                                                                                                              "site_admin": false
                                                                                                            },
                                                                                                            "created_at": "2011-04-18T23:23:56Z",
                                                                                                            "updated_at": "2011-04-18T23:23:56Z"
                                                                                                          }
                                                                                                          

                                                                                                          Edit a comment

                                                                                                          PATCH /gists/:gist_id/comments/:id
                                                                                                          

                                                                                                          Input

                                                                                                          Name Type Description
                                                                                                          body string Required. The comment text.
                                                                                                          {
                                                                                                            "body": "Just commenting for the sake of commenting"
                                                                                                          }
                                                                                                          

                                                                                                          Response

                                                                                                          Status: 200 OK
                                                                                                          
                                                                                                          {
                                                                                                            "id": 1,
                                                                                                            "url": "https://api.github.com/gists/a6db0bec360bb87e9418/comments/1",
                                                                                                            "body": "Just commenting for the sake of commenting",
                                                                                                            "user": {
                                                                                                              "login": "octocat",
                                                                                                              "id": 1,
                                                                                                              "avatar_url": "https://github.com/images/error/octocat_happy.gif",
                                                                                                              "gravatar_id": "",
                                                                                                              "url": "https://api.github.com/users/octocat",
                                                                                                              "html_url": "https://github.com/octocat",
                                                                                                              "followers_url": "https://api.github.com/users/octocat/followers",
                                                                                                              "following_url": "https://api.github.com/users/octocat/following{/other_user}",
                                                                                                              "gists_url": "https://api.github.com/users/octocat/gists{/gist_id}",
                                                                                                              "starred_url": "https://api.github.com/users/octocat/starred{/owner}{/repo}",
                                                                                                              "subscriptions_url": "https://api.github.com/users/octocat/subscriptions",
                                                                                                              "organizations_url": "https://api.github.com/users/octocat/orgs",
                                                                                                              "repos_url": "https://api.github.com/users/octocat/repos",
                                                                                                              "events_url": "https://api.github.com/users/octocat/events{/privacy}",
                                                                                                              "received_events_url": "https://api.github.com/users/octocat/received_events",
                                                                                                              "type": "User",
                                                                                                              "site_admin": false
                                                                                                            },
                                                                                                            "created_at": "2011-04-18T23:23:56Z",
                                                                                                            "updated_at": "2011-04-18T23:23:56Z"
                                                                                                          }
                                                                                                          

                                                                                                          Delete a comment

                                                                                                          DELETE /gists/:gist_id/comments/:id
                                                                                                          

                                                                                                          Response

                                                                                                          Status: 204 No Content
                                                                                                          

                                                                                                          Custom media types

                                                                                                          These are the supported media types for gist comments. You can read more about the use of media types in the API here.

                                                                                                          application/vnd.github.VERSION.raw+json
                                                                                                          application/vnd.github.VERSION.text+json
                                                                                                          application/vnd.github.VERSION.html+json
                                                                                                          application/vnd.github.VERSION.full+json
                                                                                                          
                                                                                                          tmp/developer.github.com/v3/git/index.html Git Data | GitHub Developer Guide

                                                                                                          Git Data

                                                                                                          The Git Database API gives you access to read and write raw Git objects to your Git database on GitHub and to list and update your references (branch heads and tags).

                                                                                                          This basically allows you to reimplement a lot of Git functionality over our API - by creating raw objects directly into the database and updating branch references you could technically do just about anything that Git can do without having Git installed.

                                                                                                          Git DB API functions will return a 409 Conflict if the git repository for a Repository is empty or unavailable. This typically means it is being created still. Contact GitHub support if this response status persists.

                                                                                                          git db

                                                                                                          For more information on the Git object database, please read the Git Internals chapter of the Pro Git book.

                                                                                                          As an example, if you wanted to commit a change to a file in your repository, you would:

                                                                                                          • get the current commit object
                                                                                                          • retrieve the tree it points to
                                                                                                          • retrieve the content of the blob object that tree has for that particular file path
                                                                                                          • change the content somehow and post a new blob object with that new content, getting a blob SHA back
                                                                                                          • post a new tree object with that file path pointer replaced with your new blob SHA getting a tree SHA back
                                                                                                          • create a new commit object with the current commit SHA as the parent and the new tree SHA, getting a commit SHA back
                                                                                                          • update the reference of your branch to point to the new commit SHA

                                                                                                          It might seem complex, but it's actually pretty simple when you understand the model and it opens up a ton of things you could potentially do with the API.

                                                                                                          tmp/developer.github.com/v3/git/blobs/index.html Git Blobs | GitHub Developer Guide

                                                                                                          Blobs

                                                                                                          Blobs leverage these custom media types. You can read more about the use of media types in the API here.

                                                                                                          Note: To help with migrating from our REST API v3 to GraphQL API v4, we're introducing a preview period to include the GraphQL node_id in the response for many REST API v3 resources. See the blog post for full details. To access node_id during the preview period, you must provide a custom media type in the Accept header:

                                                                                                          application/vnd.github.jean-grey-preview+json
                                                                                                          

                                                                                                          Warning: The API may change without advance notice during the preview period. Preview features are not supported for production use. If you experience any issues, contact GitHub support.

                                                                                                          Get a Blob

                                                                                                          GET /repos/:owner/:repo/git/blobs/:sha
                                                                                                          

                                                                                                          The content in the response will always be Base64 encoded.

                                                                                                          Note: This API supports blobs up to 100 megabytes in size.

                                                                                                          Response

                                                                                                          Status: 200 OK
                                                                                                          
                                                                                                          {
                                                                                                            "content": "Q29udGVudCBvZiB0aGUgYmxvYg==\n",
                                                                                                            "encoding": "base64",
                                                                                                            "url": "https://api.github.com/repos/octocat/example/git/blobs/3a0f86fb8db8eea7ccbb9a95f325ddbedfb25e15",
                                                                                                            "sha": "3a0f86fb8db8eea7ccbb9a95f325ddbedfb25e15",
                                                                                                            "size": 19
                                                                                                          }
                                                                                                          

                                                                                                          Create a Blob

                                                                                                          POST /repos/:owner/:repo/git/blobs
                                                                                                          

                                                                                                          Parameters

                                                                                                          Name Type Description
                                                                                                          content string Required. The new blob's content.
                                                                                                          encoding string The encoding used for content. Currently, "utf-8" and "base64" are supported. Default: "utf-8".

                                                                                                          Example Input

                                                                                                          {
                                                                                                            "content": "Content of the blob",
                                                                                                            "encoding": "utf-8"
                                                                                                          }
                                                                                                          

                                                                                                          Response

                                                                                                          Status: 201 Created
                                                                                                          Location: https://api.github.com/repos/octocat/example/git/blobs/3a0f86fb8db8eea7ccbb9a95f325ddbedfb25e15
                                                                                                          
                                                                                                          {
                                                                                                            "url": "https://api.github.com/repos/octocat/example/git/blobs/3a0f86fb8db8eea7ccbb9a95f325ddbedfb25e15",
                                                                                                            "sha": "3a0f86fb8db8eea7ccbb9a95f325ddbedfb25e15"
                                                                                                          }
                                                                                                          

                                                                                                          Custom media types

                                                                                                          These are the supported media types for blobs. You can read more about the use of media types in the API here.

                                                                                                          application/json
                                                                                                          application/vnd.github.VERSION.raw
                                                                                                          
                                                                                                          tmp/developer.github.com/v3/git/commits/index.html Git Commits | GitHub Developer Guide

                                                                                                          Commits

                                                                                                          Note: To help with migrating from our REST API v3 to GraphQL API v4, we're introducing a preview period to include the GraphQL node_id in the response for many REST API v3 resources. See the blog post for full details. To access node_id during the preview period, you must provide a custom media type in the Accept header:

                                                                                                          application/vnd.github.jean-grey-preview+json
                                                                                                          

                                                                                                          Warning: The API may change without advance notice during the preview period. Preview features are not supported for production use. If you experience any issues, contact GitHub support.

                                                                                                          Get a Commit

                                                                                                          GET /repos/:owner/:repo/git/commits/:sha
                                                                                                          

                                                                                                          Response

                                                                                                          Status: 200 OK
                                                                                                          
                                                                                                          {
                                                                                                            "sha": "7638417db6d59f3c431d3e1f261cc637155684cd",
                                                                                                            "url": "https://api.github.com/repos/octocat/Hello-World/git/commits/7638417db6d59f3c431d3e1f261cc637155684cd",
                                                                                                            "author": {
                                                                                                              "date": "2014-11-07T22:01:45Z",
                                                                                                              "name": "Scott Chacon",
                                                                                                              "email": "schacon@gmail.com"
                                                                                                            },
                                                                                                            "committer": {
                                                                                                              "date": "2014-11-07T22:01:45Z",
                                                                                                              "name": "Scott Chacon",
                                                                                                              "email": "schacon@gmail.com"
                                                                                                            },
                                                                                                            "message": "added readme, because im a good github citizen",
                                                                                                            "tree": {
                                                                                                              "url": "https://api.github.com/repos/octocat/Hello-World/git/trees/691272480426f78a0138979dd3ce63b77f706feb",
                                                                                                              "sha": "691272480426f78a0138979dd3ce63b77f706feb"
                                                                                                            },
                                                                                                            "parents": [
                                                                                                              {
                                                                                                                "url": "https://api.github.com/repos/octocat/Hello-World/git/commits/1acc419d4d6a9ce985db7be48c6349a0475975b5",
                                                                                                                "sha": "1acc419d4d6a9ce985db7be48c6349a0475975b5"
                                                                                                              }
                                                                                                            ],
                                                                                                            "verification": {
                                                                                                              "verified": false,
                                                                                                              "reason": "unsigned",
                                                                                                              "signature": null,
                                                                                                              "payload": null
                                                                                                            }
                                                                                                          }
                                                                                                          

                                                                                                          Create a Commit

                                                                                                          POST /repos/:owner/:repo/git/commits
                                                                                                          

                                                                                                          Parameters

                                                                                                          Name Type Description
                                                                                                          message string Required. The commit message
                                                                                                          tree string Required. The SHA of the tree object this commit points to
                                                                                                          parents array of strings Required. The SHAs of the commits that were the parents of this commit. If omitted or empty, the commit will be written as a root commit. For a single parent, an array of one SHA should be provided; for a merge commit, an array of more than one should be provided.

                                                                                                          Optional Parameters

                                                                                                          You can provide an additional committer parameter, which is an object containing information about the committer. Or, you can provide an author parameter, which is an object containing information about the author.

                                                                                                          The committer section is optional and will be filled with the author data if omitted. If the author section is omitted, it will be filled in with the authenticated user's information and the current date.

                                                                                                          Both the author and committer parameters have the same keys:

                                                                                                          Name Type Description
                                                                                                          name string The name of the author (or committer) of the commit
                                                                                                          email string The email of the author (or committer) of the commit
                                                                                                          date string Indicates when this commit was authored (or committed). This is a timestamp in ISO 8601 format: YYYY-MM-DDTHH:MM:SSZ.

                                                                                                          You can also provide an optional string signature parameter. This value will be added to the gpgsig header of the created commit. For a commit signature to be verifiable by Git or GitHub, it must be an ASCII-armored detached PGP signature over the string commit as it would be written to the object database.

                                                                                                          Note: To pass a signature parameter, you need to first manually create a valid PGP signature, which can be complicated. You may find it easier to use the command line to create signed commits.

                                                                                                          Example Input

                                                                                                          {
                                                                                                            "message": "my commit message",
                                                                                                            "author": {
                                                                                                              "name": "Scott Chacon",
                                                                                                              "email": "schacon@gmail.com",
                                                                                                              "date": "2008-07-09T16:13:30+12:00"
                                                                                                            },
                                                                                                            "parents": [
                                                                                                              "7d1b31e74ee336d15cbd21741bc88a537ed063a0"
                                                                                                            ],
                                                                                                            "tree": "827efc6d56897b048c772eb4087f854f46256132",
                                                                                                            "signature": "-----BEGIN PGP SIGNATURE-----\n\niQIzBAABAQAdFiEESn/54jMNIrGSE6Tp6cQjvhfv7nAFAlnT71cACgkQ6cQjvhfv\n7nCWwA//XVqBKWO0zF+bZl6pggvky3Oc2j1pNFuRWZ29LXpNuD5WUGXGG209B0hI\nDkmcGk19ZKUTnEUJV2Xd0R7AW01S/YSub7OYcgBkI7qUE13FVHN5ln1KvH2all2n\n2+JCV1HcJLEoTjqIFZSSu/sMdhkLQ9/NsmMAzpf/iIM0nQOyU4YRex9eD1bYj6nA\nOQPIDdAuaTQj1gFPHYLzM4zJnCqGdRlg0sOM/zC5apBNzIwlgREatOYQSCfCKV7k\nnrU34X8b9BzQaUx48Qa+Dmfn5KQ8dl27RNeWAqlkuWyv3pUauH9UeYW+KyuJeMkU\n+NyHgAsWFaCFl23kCHThbLStMZOYEnGagrd0hnm1TPS4GJkV4wfYMwnI4KuSlHKB\njHl3Js9vNzEUQipQJbgCgTiWvRJoK3ENwBTMVkKHaqT4x9U4Jk/XZB6Q8MA09ezJ\n3QgiTjTAGcum9E9QiJqMYdWQPWkaBIRRz5cET6HPB48YNXAAUsfmuYsGrnVLYbG+\nUpC6I97VybYHTy2O9XSGoaLeMI9CsFn38ycAxxbWagk5mhclNTP5mezIq6wKSwmr\nX11FW3n1J23fWZn5HJMBsRnUCgzqzX3871IqLYHqRJ/bpZ4h20RhTyPj5c/z7QXp\neSakNQMfbbMcljkha+ZMuVQX1K9aRlVqbmv3ZMWh+OijLYVU2bc=\n=5Io4\n-----END PGP SIGNATURE-----\n"
                                                                                                          }
                                                                                                          

                                                                                                          In this example, the payload that the signature is over would have been:

                                                                                                          tree 827efc6d56897b048c772eb4087f854f46256132
                                                                                                          parent 7d1b31e74ee336d15cbd21741bc88a537ed063a0
                                                                                                          author Scott Chacon <schacon@gmail.com> 1215576810 +1200
                                                                                                          committer Scott Chacon <schacon@gmail.com> 1215576810 +1200
                                                                                                          
                                                                                                          my commit message
                                                                                                          

                                                                                                          Response

                                                                                                          Status: 201 Created
                                                                                                          Location: https://api.github.com/repos/octocat/Hello-World/git/commits/7638417db6d59f3c431d3e1f261cc637155684cd
                                                                                                          
                                                                                                          {
                                                                                                            "sha": "7638417db6d59f3c431d3e1f261cc637155684cd",
                                                                                                            "url": "https://api.github.com/repos/octocat/Hello-World/git/commits/7638417db6d59f3c431d3e1f261cc637155684cd",
                                                                                                            "author": {
                                                                                                              "date": "2014-11-07T22:01:45Z",
                                                                                                              "name": "Scott Chacon",
                                                                                                              "email": "schacon@gmail.com"
                                                                                                            },
                                                                                                            "committer": {
                                                                                                              "date": "2014-11-07T22:01:45Z",
                                                                                                              "name": "Scott Chacon",
                                                                                                              "email": "schacon@gmail.com"
                                                                                                            },
                                                                                                            "message": "my commit message",
                                                                                                            "tree": {
                                                                                                              "url": "https://api.github.com/repos/octocat/Hello-World/git/trees/827efc6d56897b048c772eb4087f854f46256132",
                                                                                                              "sha": "827efc6d56897b048c772eb4087f854f46256132"
                                                                                                            },
                                                                                                            "parents": [
                                                                                                              {
                                                                                                                "url": "https://api.github.com/repos/octocat/Hello-World/git/commits/7d1b31e74ee336d15cbd21741bc88a537ed063a0",
                                                                                                                "sha": "7d1b31e74ee336d15cbd21741bc88a537ed063a0"
                                                                                                              }
                                                                                                            ],
                                                                                                            "verification": {
                                                                                                              "verified": false,
                                                                                                              "reason": "unsigned",
                                                                                                              "signature": null,
                                                                                                              "payload": null
                                                                                                            }
                                                                                                          }
                                                                                                          

                                                                                                          Commit signature verification

                                                                                                          GET /repos/:owner/:repo/git/commits/:sha
                                                                                                          

                                                                                                          Response

                                                                                                          Status: 200 OK
                                                                                                          
                                                                                                          {
                                                                                                            "sha": "7638417db6d59f3c431d3e1f261cc637155684cd",
                                                                                                            "url": "https://api.github.com/repos/octocat/Hello-World/git/commits/7638417db6d59f3c431d3e1f261cc637155684cd",
                                                                                                            "author": {
                                                                                                              "date": "2014-11-07T22:01:45Z",
                                                                                                              "name": "Scott Chacon",
                                                                                                              "email": "schacon@gmail.com"
                                                                                                            },
                                                                                                            "committer": {
                                                                                                              "date": "2014-11-07T22:01:45Z",
                                                                                                              "name": "Scott Chacon",
                                                                                                              "email": "schacon@gmail.com"
                                                                                                            },
                                                                                                            "message": "added readme, because im a good github citizen",
                                                                                                            "tree": {
                                                                                                              "url": "https://api.github.com/repos/octocat/Hello-World/git/trees/691272480426f78a0138979dd3ce63b77f706feb",
                                                                                                              "sha": "691272480426f78a0138979dd3ce63b77f706feb"
                                                                                                            },
                                                                                                            "parents": [
                                                                                                              {
                                                                                                                "url": "https://api.github.com/repos/octocat/Hello-World/git/commits/1acc419d4d6a9ce985db7be48c6349a0475975b5",
                                                                                                                "sha": "1acc419d4d6a9ce985db7be48c6349a0475975b5"
                                                                                                              }
                                                                                                            ],
                                                                                                            "verification": {
                                                                                                              "verified": true,
                                                                                                              "reason": "valid",
                                                                                                              "signature": "-----BEGIN PGP MESSAGE-----\n...\n-----END PGP MESSAGE-----",
                                                                                                              "payload": "tree 691272480426f78a0138979dd3ce63b77f706feb\n..."
                                                                                                            }
                                                                                                          }
                                                                                                          

                                                                                                          The verification object

                                                                                                          The response will include a verification field whose value is an object describing the result of verifying the commit's signature. The following fields are included in the verification object:

                                                                                                          Name Type Description
                                                                                                          verified boolean Does GitHub consider the signature in this commit to be verified?
                                                                                                          reason string The reason for verified value. Possible values and their meanings are enumerated in the table below.
                                                                                                          signature string The signature that was extracted from the commit.
                                                                                                          payload string The value that was signed.

                                                                                                          The reason field

                                                                                                          The following are possible reasons that may be included in the verification object:

                                                                                                          Value Description
                                                                                                          expired_key The key that made the signature is expired.
                                                                                                          not_signing_key The "signing" flag is not among the usage flags in the GPG key that made the signature.
                                                                                                          gpgverify_error There was an error communicating with the signature-verification service.
                                                                                                          gpgverify_unavailable The signature-verification service is currently unavailable.
                                                                                                          unsigned The object does not include a signature.
                                                                                                          unknown_signature_type A non-PGP signature was found in the commit.
                                                                                                          no_user No user was associated with the committer email address in the commit.
                                                                                                          unverified_email The committer email address in the commit was associated with a user, but the email address is not verified on her/his account.
                                                                                                          bad_email The committer email address in the commit is not included in the identities of the PGP key that made the signature.
                                                                                                          unknown_key The key that made the signature has not been registered with any user's account.
                                                                                                          malformed_signature There was an error parsing the signature.
                                                                                                          invalid The signature could not be cryptographically verified using the key whose key-id was found in the signature.
                                                                                                          valid None of the above errors applied, so the signature is considered to be verified.
                                                                                                          tmp/developer.github.com/v3/git/refs/index.html Git Refs | GitHub Developer Guide

                                                                                                          References

                                                                                                          Note: To help with migrating from our REST API v3 to GraphQL API v4, we're introducing a preview period to include the GraphQL node_id in the response for many REST API v3 resources. See the blog post for full details. To access node_id during the preview period, you must provide a custom media type in the Accept header:

                                                                                                          application/vnd.github.jean-grey-preview+json
                                                                                                          

                                                                                                          Warning: The API may change without advance notice during the preview period. Preview features are not supported for production use. If you experience any issues, contact GitHub support.

                                                                                                          Get a Reference

                                                                                                          GET /repos/:owner/:repo/git/refs/:ref
                                                                                                          

                                                                                                          The ref in the URL must be formatted as heads/branch, not just branch. For example, the call to get the data for a branch named skunkworkz/featureA would be:

                                                                                                          GET /repos/:owner/:repo/git/refs/heads/skunkworkz/featureA
                                                                                                          
                                                                                                          Status: 200 OK
                                                                                                          
                                                                                                          {
                                                                                                            "ref": "refs/heads/featureA",
                                                                                                            "url": "https://api.github.com/repos/octocat/Hello-World/git/refs/heads/featureA",
                                                                                                            "object": {
                                                                                                              "type": "commit",
                                                                                                              "sha": "aa218f56b14c9653891f9e74264a383fa43fefbd",
                                                                                                              "url": "https://api.github.com/repos/octocat/Hello-World/git/commits/aa218f56b14c9653891f9e74264a383fa43fefbd"
                                                                                                            }
                                                                                                          }
                                                                                                          

                                                                                                          If the ref doesn't exist in the repository, but existing refs start with ref they will be returned as an array. For example, a call to get the data for a branch named feature, which doesn't exist, would return head refs including featureA and featureB which do.

                                                                                                          GET /repos/:owner/:repo/git/refs/heads/feature
                                                                                                          
                                                                                                          Status: 200 OK
                                                                                                          
                                                                                                          [
                                                                                                            {
                                                                                                              "ref": "refs/heads/feature-a",
                                                                                                              "url": "https://api.github.com/repos/octocat/Hello-World/git/refs/heads/feature-a",
                                                                                                              "object": {
                                                                                                                "type": "commit",
                                                                                                                "sha": "aa218f56b14c9653891f9e74264a383fa43fefbd",
                                                                                                                "url": "https://api.github.com/repos/octocat/Hello-World/git/commits/aa218f56b14c9653891f9e74264a383fa43fefbd"
                                                                                                              }
                                                                                                            },
                                                                                                            {
                                                                                                              "ref": "refs/heads/feature-b",
                                                                                                              "url": "https://api.github.com/repos/octocat/Hello-World/git/refs/heads/feature-b",
                                                                                                              "object": {
                                                                                                                "type": "commit",
                                                                                                                "sha": "612077ae6dffb4d2fbd8ce0cccaa58893b07b5ac",
                                                                                                                "url": "https://api.github.com/repos/octocat/Hello-World/git/commits/612077ae6dffb4d2fbd8ce0cccaa58893b07b5ac"
                                                                                                              }
                                                                                                            }
                                                                                                          ]
                                                                                                          

                                                                                                          If the ref doesn't match an existing ref or any prefixes a 404 will be returned.

                                                                                                          GET /repos/:owner/:repo/git/refs/heads/feature-branch-that-no-longer-exists
                                                                                                          
                                                                                                          Status: 404 Not Found
                                                                                                          
                                                                                                          {
                                                                                                            "message": "Not Found",
                                                                                                            "documentation_url": "https://developer.github.com/v3"
                                                                                                          }
                                                                                                          

                                                                                                          Get all References

                                                                                                          GET /repos/:owner/:repo/git/refs
                                                                                                          

                                                                                                          This will return an array of all the references on the system, including things like notes and stashes if they exist on the server. Anything in the namespace, not just heads and tags, though that would be the most common.

                                                                                                          You can also request a sub-namespace. For example, to get all the tag references, you can call:

                                                                                                          GET /repos/:owner/:repo/git/refs/tags
                                                                                                          

                                                                                                          For a full refs listing, you'll get something that looks like:

                                                                                                          Status: 200 OK
                                                                                                          Link: <https://api.github.com/resource?page=2>; rel="next",
                                                                                                                <https://api.github.com/resource?page=5>; rel="last"
                                                                                                          
                                                                                                          [
                                                                                                            {
                                                                                                              "ref": "refs/heads/master",
                                                                                                              "url": "https://api.github.com/repos/octocat/Hello-World/git/refs/heads/master",
                                                                                                              "object": {
                                                                                                                "type": "commit",
                                                                                                                "sha": "aa218f56b14c9653891f9e74264a383fa43fefbd",
                                                                                                                "url": "https://api.github.com/repos/octocat/Hello-World/git/commits/aa218f56b14c9653891f9e74264a383fa43fefbd"
                                                                                                              }
                                                                                                            },
                                                                                                            {
                                                                                                              "ref": "refs/heads/gh-pages",
                                                                                                              "url": "https://api.github.com/repos/octocat/Hello-World/git/refs/heads/gh-pages",
                                                                                                              "object": {
                                                                                                                "type": "commit",
                                                                                                                "sha": "612077ae6dffb4d2fbd8ce0cccaa58893b07b5ac",
                                                                                                                "url": "https://api.github.com/repos/octocat/Hello-World/git/commits/612077ae6dffb4d2fbd8ce0cccaa58893b07b5ac"
                                                                                                              }
                                                                                                            },
                                                                                                            {
                                                                                                              "ref": "refs/tags/v0.0.1",
                                                                                                              "url": "https://api.github.com/repos/octocat/Hello-World/git/refs/tags/v0.0.1",
                                                                                                              "object": {
                                                                                                                "type": "tag",
                                                                                                                "sha": "940bd336248efae0f9ee5bc7b2d5c985887b16ac",
                                                                                                                "url": "https://api.github.com/repos/octocat/Hello-World/git/tags/940bd336248efae0f9ee5bc7b2d5c985887b16ac"
                                                                                                              }
                                                                                                            }
                                                                                                          ]
                                                                                                          

                                                                                                          Create a Reference

                                                                                                          POST /repos/:owner/:repo/git/refs
                                                                                                          

                                                                                                          Parameters

                                                                                                          Name Type Description
                                                                                                          ref type Required. The name of the fully qualified reference (ie: refs/heads/master). If it doesn't start with 'refs' and have at least two slashes, it will be rejected.
                                                                                                          sha type Required. The SHA1 value to set this reference to

                                                                                                          Input

                                                                                                          {
                                                                                                            "ref": "refs/heads/featureA",
                                                                                                            "sha": "aa218f56b14c9653891f9e74264a383fa43fefbd"
                                                                                                          }
                                                                                                          

                                                                                                          Response

                                                                                                          Status: 201 Created
                                                                                                          Location: https://api.github.com/repos/octocat/Hello-World/git/refs/heads/featureA
                                                                                                          
                                                                                                          {
                                                                                                            "ref": "refs/heads/featureA",
                                                                                                            "url": "https://api.github.com/repos/octocat/Hello-World/git/refs/heads/featureA",
                                                                                                            "object": {
                                                                                                              "type": "commit",
                                                                                                              "sha": "aa218f56b14c9653891f9e74264a383fa43fefbd",
                                                                                                              "url": "https://api.github.com/repos/octocat/Hello-World/git/commits/aa218f56b14c9653891f9e74264a383fa43fefbd"
                                                                                                            }
                                                                                                          }
                                                                                                          

                                                                                                          Update a Reference

                                                                                                          PATCH /repos/:owner/:repo/git/refs/:ref
                                                                                                          

                                                                                                          Parameters

                                                                                                          Name Type Description
                                                                                                          sha type Required. The SHA1 value to set this reference to
                                                                                                          force boolean Indicates whether to force the update or to make sure the update is a fast-forward update. Leaving this out or setting it to false will make sure you're not overwriting work. Default: false

                                                                                                          Input

                                                                                                          {
                                                                                                            "sha": "aa218f56b14c9653891f9e74264a383fa43fefbd",
                                                                                                            "force": true
                                                                                                          }
                                                                                                          

                                                                                                          Response

                                                                                                          Status: 200 OK
                                                                                                          
                                                                                                          {
                                                                                                            "ref": "refs/heads/featureA",
                                                                                                            "url": "https://api.github.com/repos/octocat/Hello-World/git/refs/heads/featureA",
                                                                                                            "object": {
                                                                                                              "type": "commit",
                                                                                                              "sha": "aa218f56b14c9653891f9e74264a383fa43fefbd",
                                                                                                              "url": "https://api.github.com/repos/octocat/Hello-World/git/commits/aa218f56b14c9653891f9e74264a383fa43fefbd"
                                                                                                            }
                                                                                                          }
                                                                                                          

                                                                                                          Delete a Reference

                                                                                                          DELETE /repos/:owner/:repo/git/refs/:ref
                                                                                                          

                                                                                                          Example: Deleting a branch:

                                                                                                          DELETE /repos/octocat/Hello-World/git/refs/heads/feature-a
                                                                                                          

                                                                                                          Example: Deleting a tag:

                                                                                                          DELETE /repos/octocat/Hello-World/git/refs/tags/v1.0
                                                                                                          

                                                                                                          Response

                                                                                                          Status: 204 No Content
                                                                                                          
                                                                                                          tmp/developer.github.com/v3/git/tags/index.html Git Tags | GitHub Developer Guide

                                                                                                          Tags

                                                                                                          This tags API only deals with tag objects - so only annotated tags, not lightweight tags.

                                                                                                          Note: To help with migrating from our REST API v3 to GraphQL API v4, we're introducing a preview period to include the GraphQL node_id in the response for many REST API v3 resources. See the blog post for full details. To access node_id during the preview period, you must provide a custom media type in the Accept header:

                                                                                                          application/vnd.github.jean-grey-preview+json
                                                                                                          

                                                                                                          Warning: The API may change without advance notice during the preview period. Preview features are not supported for production use. If you experience any issues, contact GitHub support.

                                                                                                          Get a Tag

                                                                                                          GET /repos/:owner/:repo/git/tags/:sha
                                                                                                          

                                                                                                          Response

                                                                                                          Status: 200 OK
                                                                                                          
                                                                                                          {
                                                                                                            "tag": "v0.0.1",
                                                                                                            "sha": "940bd336248efae0f9ee5bc7b2d5c985887b16ac",
                                                                                                            "url": "https://api.github.com/repos/octocat/Hello-World/git/tags/940bd336248efae0f9ee5bc7b2d5c985887b16ac",
                                                                                                            "message": "initial version",
                                                                                                            "tagger": {
                                                                                                              "name": "Scott Chacon",
                                                                                                              "email": "schacon@gmail.com",
                                                                                                              "date": "2014-11-07T22:01:45Z"
                                                                                                            },
                                                                                                            "object": {
                                                                                                              "type": "commit",
                                                                                                              "sha": "c3d0be41ecbe669545ee3e94d31ed9a4bc91ee3c",
                                                                                                              "url": "https://api.github.com/repos/octocat/Hello-World/git/commits/c3d0be41ecbe669545ee3e94d31ed9a4bc91ee3c"
                                                                                                            },
                                                                                                            "verification": {
                                                                                                              "verified": false,
                                                                                                              "reason": "unsigned",
                                                                                                              "signature": null,
                                                                                                              "payload": null
                                                                                                            }
                                                                                                          }
                                                                                                          

                                                                                                          Create a Tag Object

                                                                                                          Note that creating a tag object does not create the reference that makes a tag in Git. If you want to create an annotated tag in Git, you have to do this call to create the tag object, and then create the refs/tags/[tag] reference. If you want to create a lightweight tag, you only have to create the tag reference - this call would be unnecessary.

                                                                                                          POST /repos/:owner/:repo/git/tags
                                                                                                          

                                                                                                          Parameters

                                                                                                          Name Type Description
                                                                                                          tag string The tag
                                                                                                          message string The tag message
                                                                                                          object string The SHA of the git object this is tagging
                                                                                                          type string The type of the object we're tagging. Normally this is a commit but it can also be a tree or a blob.
                                                                                                          tagger object An object with information about the individual creating the tag.

                                                                                                          The tagger object contains the following keys:

                                                                                                          Name Type Description
                                                                                                          name string The name of the author of the tag
                                                                                                          email string The email of the author of the tag
                                                                                                          date string When this object was tagged. This is a timestamp in ISO 8601 format: YYYY-MM-DDTHH:MM:SSZ.

                                                                                                          Example Input

                                                                                                          {
                                                                                                            "tag": "v0.0.1",
                                                                                                            "message": "initial version\n",
                                                                                                            "object": "c3d0be41ecbe669545ee3e94d31ed9a4bc91ee3c",
                                                                                                            "type": "commit",
                                                                                                            "tagger": {
                                                                                                              "name": "Scott Chacon",
                                                                                                              "email": "schacon@gmail.com",
                                                                                                              "date": "2011-06-17T14:53:35-07:00"
                                                                                                            }
                                                                                                          }
                                                                                                          

                                                                                                          Response

                                                                                                          Status: 201 Created
                                                                                                          Location: https://api.github.com/repos/octocat/Hello-World/git/tags/940bd336248efae0f9ee5bc7b2d5c985887b16ac
                                                                                                          
                                                                                                          {
                                                                                                            "tag": "v0.0.1",
                                                                                                            "sha": "940bd336248efae0f9ee5bc7b2d5c985887b16ac",
                                                                                                            "url": "https://api.github.com/repos/octocat/Hello-World/git/tags/940bd336248efae0f9ee5bc7b2d5c985887b16ac",
                                                                                                            "message": "initial version",
                                                                                                            "tagger": {
                                                                                                              "name": "Scott Chacon",
                                                                                                              "email": "schacon@gmail.com",
                                                                                                              "date": "2014-11-07T22:01:45Z"
                                                                                                            },
                                                                                                            "object": {
                                                                                                              "type": "commit",
                                                                                                              "sha": "c3d0be41ecbe669545ee3e94d31ed9a4bc91ee3c",
                                                                                                              "url": "https://api.github.com/repos/octocat/Hello-World/git/commits/c3d0be41ecbe669545ee3e94d31ed9a4bc91ee3c"
                                                                                                            },
                                                                                                            "verification": {
                                                                                                              "verified": false,
                                                                                                              "reason": "unsigned",
                                                                                                              "signature": null,
                                                                                                              "payload": null
                                                                                                            }
                                                                                                          }
                                                                                                          

                                                                                                          Tag signature verification

                                                                                                          GET /repos/:owner/:repo/git/tags/:sha
                                                                                                          

                                                                                                          Response

                                                                                                          Status: 200 OK
                                                                                                          
                                                                                                          {
                                                                                                            "tag": "v0.0.1",
                                                                                                            "sha": "940bd336248efae0f9ee5bc7b2d5c985887b16ac",
                                                                                                            "url": "https://api.github.com/repos/octocat/Hello-World/git/tags/940bd336248efae0f9ee5bc7b2d5c985887b16ac",
                                                                                                            "message": "initial version",
                                                                                                            "tagger": {
                                                                                                              "name": "Scott Chacon",
                                                                                                              "email": "schacon@gmail.com",
                                                                                                              "date": "2014-11-07T22:01:45Z"
                                                                                                            },
                                                                                                            "object": {
                                                                                                              "type": "commit",
                                                                                                              "sha": "c3d0be41ecbe669545ee3e94d31ed9a4bc91ee3c",
                                                                                                              "url": "https://api.github.com/repos/octocat/Hello-World/git/commits/c3d0be41ecbe669545ee3e94d31ed9a4bc91ee3c"
                                                                                                            },
                                                                                                            "verification": {
                                                                                                              "verified": true,
                                                                                                              "reason": "valid",
                                                                                                              "signature": "-----BEGIN PGP MESSAGE-----\n...\n-----END PGP MESSAGE-----",
                                                                                                              "payload": "object c3d0be41ecbe669545ee3e94d31ed9a4bc91ee3c\n..."
                                                                                                            }
                                                                                                          }
                                                                                                          

                                                                                                          The verification object

                                                                                                          The response will include a verification field whose value is an object describing the result of verifying the tag's signature. The following fields are included in the verification object:

                                                                                                          Name Type Description
                                                                                                          verified boolean Does GitHub consider the signature in this tag to be verified?
                                                                                                          reason string The reason for verified value. Possible values and their meanings are enumerated in the table below.
                                                                                                          signature string The signature that was extracted from the tag.
                                                                                                          payload string The value that was signed.

                                                                                                          The reason field

                                                                                                          The following are possible reasons that may be included in the verification object:

                                                                                                          Value Description
                                                                                                          expired_key The key that made the signature is expired.
                                                                                                          not_signing_key The "signing" flag is not among the usage flags in the GPG key that made the signature.
                                                                                                          gpgverify_error There was an error communicating with the signature-verification service.
                                                                                                          gpgverify_unavailable The signature-verification service is currently unavailable.
                                                                                                          unsigned The object does not include a signature.
                                                                                                          unkown_signature_type A non-PGP signature was found in the tag.
                                                                                                          no_user No user was associated with the tagger email address in the tag.
                                                                                                          unverified_email The tagger email address in the tag was associated with a user, but the email address is not verified on her/his account.
                                                                                                          bad_email The tagger email address in the tag is not included in the identities of the PGP key that made the signature.
                                                                                                          unknown_key The key that made the signature has not been registered with any user's account.
                                                                                                          malformed_signature There was an error parsing the signature.
                                                                                                          invalid The signature could not be cryptographically verified using the key whose key-id was found in the signature.
                                                                                                          valid None of the above errors applied, so the signature is considered to be verified.
                                                                                                          tmp/developer.github.com/v3/git/trees/index.html Git Trees | GitHub Developer Guide

                                                                                                          Trees

                                                                                                          Get a Tree

                                                                                                          GET /repos/:owner/:repo/git/trees/:sha
                                                                                                          

                                                                                                          Response

                                                                                                          If truncated is true, the number of items in the tree array exceeded our maximum limit. If you need to fetch more items, you can clone the repository and iterate over the Git data locally.

                                                                                                          Status: 200 OK
                                                                                                          
                                                                                                          {
                                                                                                            "sha": "9fb037999f264ba9a7fc6274d15fa3ae2ab98312",
                                                                                                            "url": "https://api.github.com/repos/octocat/Hello-World/trees/9fb037999f264ba9a7fc6274d15fa3ae2ab98312",
                                                                                                            "tree": [
                                                                                                              {
                                                                                                                "path": "file.rb",
                                                                                                                "mode": "100644",
                                                                                                                "type": "blob",
                                                                                                                "size": 30,
                                                                                                                "sha": "44b4fc6d56897b048c772eb4087f854f46256132",
                                                                                                                "url": "https://api.github.com/repos/octocat/Hello-World/git/blobs/44b4fc6d56897b048c772eb4087f854f46256132"
                                                                                                              },
                                                                                                              {
                                                                                                                "path": "subdir",
                                                                                                                "mode": "040000",
                                                                                                                "type": "tree",
                                                                                                                "sha": "f484d249c660418515fb01c2b9662073663c242e",
                                                                                                                "url": "https://api.github.com/repos/octocat/Hello-World/git/blobs/f484d249c660418515fb01c2b9662073663c242e"
                                                                                                              },
                                                                                                              {
                                                                                                                "path": "exec_file",
                                                                                                                "mode": "100755",
                                                                                                                "type": "blob",
                                                                                                                "size": 75,
                                                                                                                "sha": "45b983be36b73c0788dc9cbcb76cbb80fc7bb057",
                                                                                                                "url": "https://api.github.com/repos/octocat/Hello-World/git/blobs/45b983be36b73c0788dc9cbcb76cbb80fc7bb057"
                                                                                                              }
                                                                                                            ],
                                                                                                            "truncated": false
                                                                                                          }
                                                                                                          

                                                                                                          Get a Tree Recursively

                                                                                                          GET /repos/:owner/:repo/git/trees/:sha?recursive=1
                                                                                                          

                                                                                                          Response

                                                                                                          If truncated is true, the number of items in the tree array exceeded our maximum limit. If you need to fetch more items, use the non-recursive method of fetching trees, and fetch one sub-tree at a time.

                                                                                                          Status: 200 OK
                                                                                                          
                                                                                                          {
                                                                                                            "sha": "fc6274d15fa3ae2ab983129fb037999f264ba9a7",
                                                                                                            "url": "https://api.github.com/repos/octocat/Hello-World/trees/fc6274d15fa3ae2ab983129fb037999f264ba9a7",
                                                                                                            "tree": [
                                                                                                              {
                                                                                                                "path": "subdir/file.txt",
                                                                                                                "mode": "100644",
                                                                                                                "type": "blob",
                                                                                                                "size": 132,
                                                                                                                "sha": "7c258a9869f33c1e1e1f74fbb32f07c86cb5a75b",
                                                                                                                "url": "https://api.github.com/repos/octocat/Hello-World/git/7c258a9869f33c1e1e1f74fbb32f07c86cb5a75b"
                                                                                                              }
                                                                                                            ],
                                                                                                            "truncated": false
                                                                                                          }
                                                                                                          

                                                                                                          Create a Tree

                                                                                                          The tree creation API will take nested entries as well. If both a tree and a nested path modifying that tree are specified, it will overwrite the contents of that tree with the new path contents and write a new tree out.

                                                                                                          POST /repos/:owner/:repo/git/trees
                                                                                                          

                                                                                                          Parameters

                                                                                                          Name Type Description
                                                                                                          tree array of objects Required. Objects (of path, mode, type, and sha) specifying a tree structure
                                                                                                          base_tree string The SHA1 of the tree you want to update with new data. If you don't set this, the commit will be created on top of everything; however, it will only contain your change, the rest of your files will show up as deleted.

                                                                                                          The tree parameter takes the following keys:

                                                                                                          Name Type Description
                                                                                                          path string The file referenced in the tree
                                                                                                          mode string The file mode; one of 100644 for file (blob), 100755 for executable (blob), 040000 for subdirectory (tree), 160000 for submodule (commit), or 120000 for a blob that specifies the path of a symlink
                                                                                                          type string Either blob, tree, or commit
                                                                                                          sha string The SHA1 checksum ID of the object in the tree
                                                                                                          content string The content you want this file to have. GitHub will write this blob out and use that SHA for this entry. Use either this, or tree.sha.

                                                                                                          Input

                                                                                                          {
                                                                                                            "base_tree": "9fb037999f264ba9a7fc6274d15fa3ae2ab98312",
                                                                                                            "tree": [
                                                                                                              {
                                                                                                                "path": "file.rb",
                                                                                                                "mode": "100644",
                                                                                                                "type": "blob",
                                                                                                                "sha": "44b4fc6d56897b048c772eb4087f854f46256132"
                                                                                                              }
                                                                                                            ]
                                                                                                          }
                                                                                                          

                                                                                                          Response

                                                                                                          Status: 201 Created
                                                                                                          Location: https://api.github.com/repos/octocat/Hello-World/trees/cd8274d15fa3ae2ab983129fb037999f264ba9a7
                                                                                                          
                                                                                                          {
                                                                                                            "sha": "cd8274d15fa3ae2ab983129fb037999f264ba9a7",
                                                                                                            "url": "https://api.github.com/repos/octocat/Hello-World/trees/cd8274d15fa3ae2ab983129fb037999f264ba9a7",
                                                                                                            "tree": [
                                                                                                              {
                                                                                                                "path": "file.rb",
                                                                                                                "mode": "100644",
                                                                                                                "type": "blob",
                                                                                                                "size": 132,
                                                                                                                "sha": "7c258a9869f33c1e1e1f74fbb32f07c86cb5a75b",
                                                                                                                "url": "https://api.github.com/repos/octocat/Hello-World/git/blobs/7c258a9869f33c1e1e1f74fbb32f07c86cb5a75b"
                                                                                                              }
                                                                                                            ]
                                                                                                          }
                                                                                                          
                                                                                                          tmp/developer.github.com/v3/gitignore/index.html Gitignore | GitHub Developer Guide

                                                                                                          Gitignore

                                                                                                          When you create a new GitHub repository via the API, you can specify a .gitignore template to apply to the repository upon creation. The .gitignore Templates API lists and fetches templates from the GitHub .gitignore repository.

                                                                                                          Listing available templates

                                                                                                          List all templates available to pass as an option when creating a repository.

                                                                                                          GET /gitignore/templates
                                                                                                          

                                                                                                          Response

                                                                                                          Status: 200 OK
                                                                                                          
                                                                                                          [
                                                                                                            "Actionscript",
                                                                                                            "Android",
                                                                                                            "AppceleratorTitanium",
                                                                                                            "Autotools",
                                                                                                            "Bancha",
                                                                                                            "C",
                                                                                                            "C++"
                                                                                                          ]
                                                                                                          

                                                                                                          Get a single template

                                                                                                          The API also allows fetching the source of a single template.

                                                                                                          GET /gitignore/templates/C
                                                                                                          

                                                                                                          Response

                                                                                                          Status: 200 OK
                                                                                                          
                                                                                                          {
                                                                                                            "name": "C",
                                                                                                            "source": "# Object files\n*.o\n\n# Libraries\n*.lib\n*.a\n\n# Shared objects (inc. Windows DLLs)\n*.dll\n*.so\n*.so.*\n*.dylib\n\n# Executables\n*.exe\n*.out\n*.app\n"
                                                                                                          }
                                                                                                          

                                                                                                          Use the raw media type to get the raw contents.

                                                                                                          Status: 200 OK
                                                                                                          
                                                                                                          # Object files
                                                                                                          *.o
                                                                                                          
                                                                                                          # Libraries
                                                                                                          *.lib
                                                                                                          *.a
                                                                                                          
                                                                                                          # Shared objects (inc. Windows DLLs)
                                                                                                          *.dll
                                                                                                          *.so
                                                                                                          *.so.*
                                                                                                          *.dylib
                                                                                                          
                                                                                                          # Executables
                                                                                                          *.exe
                                                                                                          *.out
                                                                                                          *.app
                                                                                                          
                                                                                                          tmp/developer.github.com/v3/guides/index.html Development Guides | GitHub Developer Guide

                                                                                                          Development Guides

                                                                                                          This section of the documentation is intended to get you up-and-running with real-world GitHub API applications. We'll cover everything you need to know, from authentication, to manipulating results, to combining results with other services.

                                                                                                          Every tutorial here will have a project, and every project will be stored and documented in our public platform-samples repository.

                                                                                                          The Electrocat

                                                                                                          tmp/developer.github.com/v3/issues/index.html Issues | GitHub Developer Guide

                                                                                                          Issues

                                                                                                          Issues use these custom media types. You can read more about the use of media types in the API here.

                                                                                                          Note: To help with migrating from our REST API v3 to GraphQL API v4, we're introducing a preview period to include the GraphQL node_id in the response for many REST API v3 resources. See the blog post for full details. To access node_id during the preview period, you must provide a custom media type in the Accept header:

                                                                                                          application/vnd.github.jean-grey-preview+json
                                                                                                          

                                                                                                          Warning: The API may change without advance notice during the preview period. Preview features are not supported for production use. If you experience any issues, contact GitHub support.

                                                                                                          List issues

                                                                                                          Note: In the past, pull requests and issues were more closely aligned than they are now. As far as the API is concerned, every pull request is an issue, but not every issue is a pull request.

                                                                                                          This endpoint may also return pull requests in the response. If an issue is a pull request, the object will include a pull_request key.

                                                                                                          List all issues assigned to the authenticated user across all visible repositories including owned repositories, member repositories, and organization repositories:

                                                                                                          GET /issues
                                                                                                          

                                                                                                          You can use the filter query parameter to fetch issues that are not necessarily assigned to you. See the table below for more information.

                                                                                                          List all issues across owned and member repositories assigned to the authenticated user:

                                                                                                          GET /user/issues
                                                                                                          

                                                                                                          List all issues for a given organization assigned to the authenticated user:

                                                                                                          GET /orgs/:org/issues
                                                                                                          

                                                                                                          Parameters

                                                                                                          Name Type Description
                                                                                                          filter string Indicates which sorts of issues to return. Can be one of:
                                                                                                          * assigned: Issues assigned to you
                                                                                                          * created: Issues created by you
                                                                                                          * mentioned: Issues mentioning you
                                                                                                          * subscribed: Issues you're subscribed to updates for
                                                                                                          * all: All issues the authenticated user can see, regardless of participation or creation
                                                                                                          Default: assigned
                                                                                                          state string Indicates the state of the issues to return. Can be either open, closed, or all. Default: open
                                                                                                          labels string A list of comma separated label names. Example: bug,ui,@high
                                                                                                          sort string What to sort results by. Can be either created, updated, comments. Default: created
                                                                                                          direction string The direction of the sort. Can be either asc or desc. Default: desc
                                                                                                          since string Only issues updated at or after this time are returned. This is a timestamp in ISO 8601 format: YYYY-MM-DDTHH:MM:SSZ.

                                                                                                          Response

                                                                                                          Status: 200 OK
                                                                                                          Link: <https://api.github.com/resource?page=2>; rel="next",
                                                                                                                <https://api.github.com/resource?page=5>; rel="last"
                                                                                                          
                                                                                                          [
                                                                                                            {
                                                                                                              "id": 1,
                                                                                                              "url": "https://api.github.com/repos/octocat/Hello-World/issues/1347",
                                                                                                              "repository_url": "https://api.github.com/repos/octocat/Hello-World",
                                                                                                              "labels_url": "https://api.github.com/repos/octocat/Hello-World/issues/1347/labels{/name}",
                                                                                                              "comments_url": "https://api.github.com/repos/octocat/Hello-World/issues/1347/comments",
                                                                                                              "events_url": "https://api.github.com/repos/octocat/Hello-World/issues/1347/events",
                                                                                                              "html_url": "https://github.com/octocat/Hello-World/issues/1347",
                                                                                                              "number": 1347,
                                                                                                              "state": "open",
                                                                                                              "title": "Found a bug",
                                                                                                              "body": "I'm having a problem with this.",
                                                                                                              "user": {
                                                                                                                "login": "octocat",
                                                                                                                "id": 1,
                                                                                                                "avatar_url": "https://github.com/images/error/octocat_happy.gif",
                                                                                                                "gravatar_id": "",
                                                                                                                "url": "https://api.github.com/users/octocat",
                                                                                                                "html_url": "https://github.com/octocat",
                                                                                                                "followers_url": "https://api.github.com/users/octocat/followers",
                                                                                                                "following_url": "https://api.github.com/users/octocat/following{/other_user}",
                                                                                                                "gists_url": "https://api.github.com/users/octocat/gists{/gist_id}",
                                                                                                                "starred_url": "https://api.github.com/users/octocat/starred{/owner}{/repo}",
                                                                                                                "subscriptions_url": "https://api.github.com/users/octocat/subscriptions",
                                                                                                                "organizations_url": "https://api.github.com/users/octocat/orgs",
                                                                                                                "repos_url": "https://api.github.com/users/octocat/repos",
                                                                                                                "events_url": "https://api.github.com/users/octocat/events{/privacy}",
                                                                                                                "received_events_url": "https://api.github.com/users/octocat/received_events",
                                                                                                                "type": "User",
                                                                                                                "site_admin": false
                                                                                                              },
                                                                                                              "labels": [
                                                                                                                {
                                                                                                                  "id": 208045946,
                                                                                                                  "url": "https://api.github.com/repos/octocat/Hello-World/labels/bug",
                                                                                                                  "name": "bug",
                                                                                                                  "color": "f29513",
                                                                                                                  "default": true
                                                                                                                }
                                                                                                              ],
                                                                                                              "assignee": {
                                                                                                                "login": "octocat",
                                                                                                                "id": 1,
                                                                                                                "avatar_url": "https://github.com/images/error/octocat_happy.gif",
                                                                                                                "gravatar_id": "",
                                                                                                                "url": "https://api.github.com/users/octocat",
                                                                                                                "html_url": "https://github.com/octocat",
                                                                                                                "followers_url": "https://api.github.com/users/octocat/followers",
                                                                                                                "following_url": "https://api.github.com/users/octocat/following{/other_user}",
                                                                                                                "gists_url": "https://api.github.com/users/octocat/gists{/gist_id}",
                                                                                                                "starred_url": "https://api.github.com/users/octocat/starred{/owner}{/repo}",
                                                                                                                "subscriptions_url": "https://api.github.com/users/octocat/subscriptions",
                                                                                                                "organizations_url": "https://api.github.com/users/octocat/orgs",
                                                                                                                "repos_url": "https://api.github.com/users/octocat/repos",
                                                                                                                "events_url": "https://api.github.com/users/octocat/events{/privacy}",
                                                                                                                "received_events_url": "https://api.github.com/users/octocat/received_events",
                                                                                                                "type": "User",
                                                                                                                "site_admin": false
                                                                                                              },
                                                                                                              "assignees": [
                                                                                                                {
                                                                                                                  "login": "octocat",
                                                                                                                  "id": 1,
                                                                                                                  "avatar_url": "https://github.com/images/error/octocat_happy.gif",
                                                                                                                  "gravatar_id": "",
                                                                                                                  "url": "https://api.github.com/users/octocat",
                                                                                                                  "html_url": "https://github.com/octocat",
                                                                                                                  "followers_url": "https://api.github.com/users/octocat/followers",
                                                                                                                  "following_url": "https://api.github.com/users/octocat/following{/other_user}",
                                                                                                                  "gists_url": "https://api.github.com/users/octocat/gists{/gist_id}",
                                                                                                                  "starred_url": "https://api.github.com/users/octocat/starred{/owner}{/repo}",
                                                                                                                  "subscriptions_url": "https://api.github.com/users/octocat/subscriptions",
                                                                                                                  "organizations_url": "https://api.github.com/users/octocat/orgs",
                                                                                                                  "repos_url": "https://api.github.com/users/octocat/repos",
                                                                                                                  "events_url": "https://api.github.com/users/octocat/events{/privacy}",
                                                                                                                  "received_events_url": "https://api.github.com/users/octocat/received_events",
                                                                                                                  "type": "User",
                                                                                                                  "site_admin": false
                                                                                                                }
                                                                                                              ],
                                                                                                              "milestone": {
                                                                                                                "url": "https://api.github.com/repos/octocat/Hello-World/milestones/1",
                                                                                                                "html_url": "https://github.com/octocat/Hello-World/milestones/v1.0",
                                                                                                                "labels_url": "https://api.github.com/repos/octocat/Hello-World/milestones/1/labels",
                                                                                                                "id": 1002604,
                                                                                                                "number": 1,
                                                                                                                "state": "open",
                                                                                                                "title": "v1.0",
                                                                                                                "description": "Tracking milestone for version 1.0",
                                                                                                                "creator": {
                                                                                                                  "login": "octocat",
                                                                                                                  "id": 1,
                                                                                                                  "avatar_url": "https://github.com/images/error/octocat_happy.gif",
                                                                                                                  "gravatar_id": "",
                                                                                                                  "url": "https://api.github.com/users/octocat",
                                                                                                                  "html_url": "https://github.com/octocat",
                                                                                                                  "followers_url": "https://api.github.com/users/octocat/followers",
                                                                                                                  "following_url": "https://api.github.com/users/octocat/following{/other_user}",
                                                                                                                  "gists_url": "https://api.github.com/users/octocat/gists{/gist_id}",
                                                                                                                  "starred_url": "https://api.github.com/users/octocat/starred{/owner}{/repo}",
                                                                                                                  "subscriptions_url": "https://api.github.com/users/octocat/subscriptions",
                                                                                                                  "organizations_url": "https://api.github.com/users/octocat/orgs",
                                                                                                                  "repos_url": "https://api.github.com/users/octocat/repos",
                                                                                                                  "events_url": "https://api.github.com/users/octocat/events{/privacy}",
                                                                                                                  "received_events_url": "https://api.github.com/users/octocat/received_events",
                                                                                                                  "type": "User",
                                                                                                                  "site_admin": false
                                                                                                                },
                                                                                                                "open_issues": 4,
                                                                                                                "closed_issues": 8,
                                                                                                                "created_at": "2011-04-10T20:09:31Z",
                                                                                                                "updated_at": "2014-03-03T18:58:10Z",
                                                                                                                "closed_at": "2013-02-12T13:22:01Z",
                                                                                                                "due_on": "2012-10-09T23:39:01Z"
                                                                                                              },
                                                                                                              "locked": true,
                                                                                                              "active_lock_reason": "too heated",
                                                                                                              "comments": 0,
                                                                                                              "pull_request": {
                                                                                                                "url": "https://api.github.com/repos/octocat/Hello-World/pulls/1347",
                                                                                                                "html_url": "https://github.com/octocat/Hello-World/pull/1347",
                                                                                                                "diff_url": "https://github.com/octocat/Hello-World/pull/1347.diff",
                                                                                                                "patch_url": "https://github.com/octocat/Hello-World/pull/1347.patch"
                                                                                                              },
                                                                                                              "closed_at": null,
                                                                                                              "created_at": "2011-04-22T13:33:48Z",
                                                                                                              "updated_at": "2011-04-22T13:33:48Z",
                                                                                                              "repository": {
                                                                                                                "id": 1296269,
                                                                                                                "owner": {
                                                                                                                  "login": "octocat",
                                                                                                                  "id": 1,
                                                                                                                  "avatar_url": "https://github.com/images/error/octocat_happy.gif",
                                                                                                                  "gravatar_id": "",
                                                                                                                  "url": "https://api.github.com/users/octocat",
                                                                                                                  "html_url": "https://github.com/octocat",
                                                                                                                  "followers_url": "https://api.github.com/users/octocat/followers",
                                                                                                                  "following_url": "https://api.github.com/users/octocat/following{/other_user}",
                                                                                                                  "gists_url": "https://api.github.com/users/octocat/gists{/gist_id}",
                                                                                                                  "starred_url": "https://api.github.com/users/octocat/starred{/owner}{/repo}",
                                                                                                                  "subscriptions_url": "https://api.github.com/users/octocat/subscriptions",
                                                                                                                  "organizations_url": "https://api.github.com/users/octocat/orgs",
                                                                                                                  "repos_url": "https://api.github.com/users/octocat/repos",
                                                                                                                  "events_url": "https://api.github.com/users/octocat/events{/privacy}",
                                                                                                                  "received_events_url": "https://api.github.com/users/octocat/received_events",
                                                                                                                  "type": "User",
                                                                                                                  "site_admin": false
                                                                                                                },
                                                                                                                "name": "Hello-World",
                                                                                                                "full_name": "octocat/Hello-World",
                                                                                                                "description": "This your first repo!",
                                                                                                                "private": false,
                                                                                                                "fork": false,
                                                                                                                "url": "https://api.github.com/repos/octocat/Hello-World",
                                                                                                                "html_url": "https://github.com/octocat/Hello-World",
                                                                                                                "archive_url": "http://api.github.com/repos/octocat/Hello-World/{archive_format}{/ref}",
                                                                                                                "assignees_url": "http://api.github.com/repos/octocat/Hello-World/assignees{/user}",
                                                                                                                "blobs_url": "http://api.github.com/repos/octocat/Hello-World/git/blobs{/sha}",
                                                                                                                "branches_url": "http://api.github.com/repos/octocat/Hello-World/branches{/branch}",
                                                                                                                "clone_url": "https://github.com/octocat/Hello-World.git",
                                                                                                                "collaborators_url": "http://api.github.com/repos/octocat/Hello-World/collaborators{/collaborator}",
                                                                                                                "comments_url": "http://api.github.com/repos/octocat/Hello-World/comments{/number}",
                                                                                                                "commits_url": "http://api.github.com/repos/octocat/Hello-World/commits{/sha}",
                                                                                                                "compare_url": "http://api.github.com/repos/octocat/Hello-World/compare/{base}...{head}",
                                                                                                                "contents_url": "http://api.github.com/repos/octocat/Hello-World/contents/{+path}",
                                                                                                                "contributors_url": "http://api.github.com/repos/octocat/Hello-World/contributors",
                                                                                                                "deployments_url": "http://api.github.com/repos/octocat/Hello-World/deployments",
                                                                                                                "downloads_url": "http://api.github.com/repos/octocat/Hello-World/downloads",
                                                                                                                "events_url": "http://api.github.com/repos/octocat/Hello-World/events",
                                                                                                                "forks_url": "http://api.github.com/repos/octocat/Hello-World/forks",
                                                                                                                "git_commits_url": "http://api.github.com/repos/octocat/Hello-World/git/commits{/sha}",
                                                                                                                "git_refs_url": "http://api.github.com/repos/octocat/Hello-World/git/refs{/sha}",
                                                                                                                "git_tags_url": "http://api.github.com/repos/octocat/Hello-World/git/tags{/sha}",
                                                                                                                "git_url": "git:github.com/octocat/Hello-World.git",
                                                                                                                "hooks_url": "http://api.github.com/repos/octocat/Hello-World/hooks",
                                                                                                                "issue_comment_url": "http://api.github.com/repos/octocat/Hello-World/issues/comments{/number}",
                                                                                                                "issue_events_url": "http://api.github.com/repos/octocat/Hello-World/issues/events{/number}",
                                                                                                                "issues_url": "http://api.github.com/repos/octocat/Hello-World/issues{/number}",
                                                                                                                "keys_url": "http://api.github.com/repos/octocat/Hello-World/keys{/key_id}",
                                                                                                                "labels_url": "http://api.github.com/repos/octocat/Hello-World/labels{/name}",
                                                                                                                "languages_url": "http://api.github.com/repos/octocat/Hello-World/languages",
                                                                                                                "merges_url": "http://api.github.com/repos/octocat/Hello-World/merges",
                                                                                                                "milestones_url": "http://api.github.com/repos/octocat/Hello-World/milestones{/number}",
                                                                                                                "mirror_url": "git:git.example.com/octocat/Hello-World",
                                                                                                                "notifications_url": "http://api.github.com/repos/octocat/Hello-World/notifications{?since,all,participating}",
                                                                                                                "pulls_url": "http://api.github.com/repos/octocat/Hello-World/pulls{/number}",
                                                                                                                "releases_url": "http://api.github.com/repos/octocat/Hello-World/releases{/id}",
                                                                                                                "ssh_url": "git@github.com:octocat/Hello-World.git",
                                                                                                                "stargazers_url": "http://api.github.com/repos/octocat/Hello-World/stargazers",
                                                                                                                "statuses_url": "http://api.github.com/repos/octocat/Hello-World/statuses/{sha}",
                                                                                                                "subscribers_url": "http://api.github.com/repos/octocat/Hello-World/subscribers",
                                                                                                                "subscription_url": "http://api.github.com/repos/octocat/Hello-World/subscription",
                                                                                                                "svn_url": "https://svn.github.com/octocat/Hello-World",
                                                                                                                "tags_url": "http://api.github.com/repos/octocat/Hello-World/tags",
                                                                                                                "teams_url": "http://api.github.com/repos/octocat/Hello-World/teams",
                                                                                                                "trees_url": "http://api.github.com/repos/octocat/Hello-World/git/trees{/sha}",
                                                                                                                "homepage": "https://github.com",
                                                                                                                "language": null,
                                                                                                                "forks_count": 9,
                                                                                                                "stargazers_count": 80,
                                                                                                                "watchers_count": 80,
                                                                                                                "size": 108,
                                                                                                                "default_branch": "master",
                                                                                                                "open_issues_count": 0,
                                                                                                                "topics": [
                                                                                                                  "octocat",
                                                                                                                  "atom",
                                                                                                                  "electron",
                                                                                                                  "API"
                                                                                                                ],
                                                                                                                "has_issues": true,
                                                                                                                "has_wiki": true,
                                                                                                                "has_pages": false,
                                                                                                                "has_downloads": true,
                                                                                                                "archived": false,
                                                                                                                "pushed_at": "2011-01-26T19:06:43Z",
                                                                                                                "created_at": "2011-01-26T19:01:12Z",
                                                                                                                "updated_at": "2011-01-26T19:14:43Z",
                                                                                                                "permissions": {
                                                                                                                  "admin": false,
                                                                                                                  "push": false,
                                                                                                                  "pull": true
                                                                                                                },
                                                                                                                "allow_rebase_merge": true,
                                                                                                                "allow_squash_merge": true,
                                                                                                                "allow_merge_commit": true,
                                                                                                                "subscribers_count": 42,
                                                                                                                "network_count": 0
                                                                                                              }
                                                                                                            }
                                                                                                          ]
                                                                                                          

                                                                                                          Reactions summary

                                                                                                          An additional reactions object in the issue payload is currently available for developers to preview. During the preview period, the APIs may change without advance notice. Please see the blog post for full details.

                                                                                                          To access the API you must provide a custom media type in the Accept header:

                                                                                                            application/vnd.github.squirrel-girl-preview
                                                                                                          

                                                                                                          The reactions key will have the following payload where url can be used to construct the API location for listing and creating reactions.

                                                                                                          {
                                                                                                            "total_count": 5,
                                                                                                            "+1": 3,
                                                                                                            "-1": 1,
                                                                                                            "laugh": 0,
                                                                                                            "confused": 0,
                                                                                                            "heart": 1,
                                                                                                            "hooray": 0,
                                                                                                            "url": "https://api.github.com/repos/octocat/Hello-World/issues/1347/reactions"
                                                                                                          }
                                                                                                          

                                                                                                          Issues opened by users via integrations

                                                                                                          Note: An additional performed_via_github_app object in the issue payload is currently available for developers to preview. For more information, see the related blog post.

                                                                                                          To access the API, you must provide a custom media type in the Accept header:

                                                                                                          application/vnd.github.machine-man-preview
                                                                                                          

                                                                                                          Note: If a user opened an issue via a GitHub App, the performed_via_github_app key contains information on that GitHub App.

                                                                                                          Warning: The API may change without advance notice during the preview period. Preview features are not supported for production use. If you experience any issues, contact GitHub support.

                                                                                                          List issues for a repository

                                                                                                          Note: In the past, pull requests and issues were more closely aligned than they are now. As far as the API is concerned, every pull request is an issue, but not every issue is a pull request.

                                                                                                          This endpoint may also return pull requests in the response. If an issue is a pull request, the object will include a pull_request key.

                                                                                                          GET /repos/:owner/:repo/issues
                                                                                                          

                                                                                                          Parameters

                                                                                                          Name Type Description
                                                                                                          milestone integer or string If an integer is passed, it should refer to a milestone by its number field. If the string * is passed, issues with any milestone are accepted. If the string none is passed, issues without milestones are returned.
                                                                                                          state string Indicates the state of the issues to return. Can be either open, closed, or all. Default: open
                                                                                                          assignee string Can be the name of a user. Pass in none for issues with no assigned user, and * for issues assigned to any user.
                                                                                                          creator string The user that created the issue.
                                                                                                          mentioned string A user that's mentioned in the issue.
                                                                                                          labels string A list of comma separated label names. Example: bug,ui,@high
                                                                                                          sort string What to sort results by. Can be either created, updated, comments. Default: created
                                                                                                          direction string The direction of the sort. Can be either asc or desc. Default: desc
                                                                                                          since string Only issues updated at or after this time are returned. This is a timestamp in ISO 8601 format: YYYY-MM-DDTHH:MM:SSZ.

                                                                                                          Response

                                                                                                          Status: 200 OK
                                                                                                          Link: <https://api.github.com/resource?page=2>; rel="next",
                                                                                                                <https://api.github.com/resource?page=5>; rel="last"
                                                                                                          
                                                                                                          [
                                                                                                            {
                                                                                                              "id": 1,
                                                                                                              "url": "https://api.github.com/repos/octocat/Hello-World/issues/1347",
                                                                                                              "repository_url": "https://api.github.com/repos/octocat/Hello-World",
                                                                                                              "labels_url": "https://api.github.com/repos/octocat/Hello-World/issues/1347/labels{/name}",
                                                                                                              "comments_url": "https://api.github.com/repos/octocat/Hello-World/issues/1347/comments",
                                                                                                              "events_url": "https://api.github.com/repos/octocat/Hello-World/issues/1347/events",
                                                                                                              "html_url": "https://github.com/octocat/Hello-World/issues/1347",
                                                                                                              "number": 1347,
                                                                                                              "state": "open",
                                                                                                              "title": "Found a bug",
                                                                                                              "body": "I'm having a problem with this.",
                                                                                                              "user": {
                                                                                                                "login": "octocat",
                                                                                                                "id": 1,
                                                                                                                "avatar_url": "https://github.com/images/error/octocat_happy.gif",
                                                                                                                "gravatar_id": "",
                                                                                                                "url": "https://api.github.com/users/octocat",
                                                                                                                "html_url": "https://github.com/octocat",
                                                                                                                "followers_url": "https://api.github.com/users/octocat/followers",
                                                                                                                "following_url": "https://api.github.com/users/octocat/following{/other_user}",
                                                                                                                "gists_url": "https://api.github.com/users/octocat/gists{/gist_id}",
                                                                                                                "starred_url": "https://api.github.com/users/octocat/starred{/owner}{/repo}",
                                                                                                                "subscriptions_url": "https://api.github.com/users/octocat/subscriptions",
                                                                                                                "organizations_url": "https://api.github.com/users/octocat/orgs",
                                                                                                                "repos_url": "https://api.github.com/users/octocat/repos",
                                                                                                                "events_url": "https://api.github.com/users/octocat/events{/privacy}",
                                                                                                                "received_events_url": "https://api.github.com/users/octocat/received_events",
                                                                                                                "type": "User",
                                                                                                                "site_admin": false
                                                                                                              },
                                                                                                              "labels": [
                                                                                                                {
                                                                                                                  "id": 208045946,
                                                                                                                  "url": "https://api.github.com/repos/octocat/Hello-World/labels/bug",
                                                                                                                  "name": "bug",
                                                                                                                  "color": "f29513",
                                                                                                                  "default": true
                                                                                                                }
                                                                                                              ],
                                                                                                              "assignee": {
                                                                                                                "login": "octocat",
                                                                                                                "id": 1,
                                                                                                                "avatar_url": "https://github.com/images/error/octocat_happy.gif",
                                                                                                                "gravatar_id": "",
                                                                                                                "url": "https://api.github.com/users/octocat",
                                                                                                                "html_url": "https://github.com/octocat",
                                                                                                                "followers_url": "https://api.github.com/users/octocat/followers",
                                                                                                                "following_url": "https://api.github.com/users/octocat/following{/other_user}",
                                                                                                                "gists_url": "https://api.github.com/users/octocat/gists{/gist_id}",
                                                                                                                "starred_url": "https://api.github.com/users/octocat/starred{/owner}{/repo}",
                                                                                                                "subscriptions_url": "https://api.github.com/users/octocat/subscriptions",
                                                                                                                "organizations_url": "https://api.github.com/users/octocat/orgs",
                                                                                                                "repos_url": "https://api.github.com/users/octocat/repos",
                                                                                                                "events_url": "https://api.github.com/users/octocat/events{/privacy}",
                                                                                                                "received_events_url": "https://api.github.com/users/octocat/received_events",
                                                                                                                "type": "User",
                                                                                                                "site_admin": false
                                                                                                              },
                                                                                                              "assignees": [
                                                                                                                {
                                                                                                                  "login": "octocat",
                                                                                                                  "id": 1,
                                                                                                                  "avatar_url": "https://github.com/images/error/octocat_happy.gif",
                                                                                                                  "gravatar_id": "",
                                                                                                                  "url": "https://api.github.com/users/octocat",
                                                                                                                  "html_url": "https://github.com/octocat",
                                                                                                                  "followers_url": "https://api.github.com/users/octocat/followers",
                                                                                                                  "following_url": "https://api.github.com/users/octocat/following{/other_user}",
                                                                                                                  "gists_url": "https://api.github.com/users/octocat/gists{/gist_id}",
                                                                                                                  "starred_url": "https://api.github.com/users/octocat/starred{/owner}{/repo}",
                                                                                                                  "subscriptions_url": "https://api.github.com/users/octocat/subscriptions",
                                                                                                                  "organizations_url": "https://api.github.com/users/octocat/orgs",
                                                                                                                  "repos_url": "https://api.github.com/users/octocat/repos",
                                                                                                                  "events_url": "https://api.github.com/users/octocat/events{/privacy}",
                                                                                                                  "received_events_url": "https://api.github.com/users/octocat/received_events",
                                                                                                                  "type": "User",
                                                                                                                  "site_admin": false
                                                                                                                }
                                                                                                              ],
                                                                                                              "milestone": {
                                                                                                                "url": "https://api.github.com/repos/octocat/Hello-World/milestones/1",
                                                                                                                "html_url": "https://github.com/octocat/Hello-World/milestones/v1.0",
                                                                                                                "labels_url": "https://api.github.com/repos/octocat/Hello-World/milestones/1/labels",
                                                                                                                "id": 1002604,
                                                                                                                "number": 1,
                                                                                                                "state": "open",
                                                                                                                "title": "v1.0",
                                                                                                                "description": "Tracking milestone for version 1.0",
                                                                                                                "creator": {
                                                                                                                  "login": "octocat",
                                                                                                                  "id": 1,
                                                                                                                  "avatar_url": "https://github.com/images/error/octocat_happy.gif",
                                                                                                                  "gravatar_id": "",
                                                                                                                  "url": "https://api.github.com/users/octocat",
                                                                                                                  "html_url": "https://github.com/octocat",
                                                                                                                  "followers_url": "https://api.github.com/users/octocat/followers",
                                                                                                                  "following_url": "https://api.github.com/users/octocat/following{/other_user}",
                                                                                                                  "gists_url": "https://api.github.com/users/octocat/gists{/gist_id}",
                                                                                                                  "starred_url": "https://api.github.com/users/octocat/starred{/owner}{/repo}",
                                                                                                                  "subscriptions_url": "https://api.github.com/users/octocat/subscriptions",
                                                                                                                  "organizations_url": "https://api.github.com/users/octocat/orgs",
                                                                                                                  "repos_url": "https://api.github.com/users/octocat/repos",
                                                                                                                  "events_url": "https://api.github.com/users/octocat/events{/privacy}",
                                                                                                                  "received_events_url": "https://api.github.com/users/octocat/received_events",
                                                                                                                  "type": "User",
                                                                                                                  "site_admin": false
                                                                                                                },
                                                                                                                "open_issues": 4,
                                                                                                                "closed_issues": 8,
                                                                                                                "created_at": "2011-04-10T20:09:31Z",
                                                                                                                "updated_at": "2014-03-03T18:58:10Z",
                                                                                                                "closed_at": "2013-02-12T13:22:01Z",
                                                                                                                "due_on": "2012-10-09T23:39:01Z"
                                                                                                              },
                                                                                                              "locked": true,
                                                                                                              "active_lock_reason": "too heated",
                                                                                                              "comments": 0,
                                                                                                              "pull_request": {
                                                                                                                "url": "https://api.github.com/repos/octocat/Hello-World/pulls/1347",
                                                                                                                "html_url": "https://github.com/octocat/Hello-World/pull/1347",
                                                                                                                "diff_url": "https://github.com/octocat/Hello-World/pull/1347.diff",
                                                                                                                "patch_url": "https://github.com/octocat/Hello-World/pull/1347.patch"
                                                                                                              },
                                                                                                              "closed_at": null,
                                                                                                              "created_at": "2011-04-22T13:33:48Z",
                                                                                                              "updated_at": "2011-04-22T13:33:48Z"
                                                                                                            }
                                                                                                          ]
                                                                                                          

                                                                                                          Reactions summary

                                                                                                          An additional reactions object in the issue payload is currently available for developers to preview. During the preview period, the APIs may change without advance notice. Please see the blog post for full details.

                                                                                                          To access the API you must provide a custom media type in the Accept header:

                                                                                                            application/vnd.github.squirrel-girl-preview
                                                                                                          

                                                                                                          The reactions key will have the following payload where url can be used to construct the API location for listing and creating reactions.

                                                                                                          {
                                                                                                            "total_count": 5,
                                                                                                            "+1": 3,
                                                                                                            "-1": 1,
                                                                                                            "laugh": 0,
                                                                                                            "confused": 0,
                                                                                                            "heart": 1,
                                                                                                            "hooray": 0,
                                                                                                            "url": "https://api.github.com/repos/octocat/Hello-World/issues/1347/reactions"
                                                                                                          }
                                                                                                          

                                                                                                          Issues opened by users via integrations

                                                                                                          Note: An additional performed_via_github_app object in the issue payload is currently available for developers to preview. For more information, see the related blog post.

                                                                                                          To access the API, you must provide a custom media type in the Accept header:

                                                                                                          application/vnd.github.machine-man-preview
                                                                                                          

                                                                                                          Note: If a user opened an issue via a GitHub App, the performed_via_github_app key contains information on that GitHub App.

                                                                                                          Warning: The API may change without advance notice during the preview period. Preview features are not supported for production use. If you experience any issues, contact GitHub support.

                                                                                                          Get a single issue

                                                                                                          Note: In the past, pull requests and issues were more closely aligned than they are now. As far as the API is concerned, every pull request is an issue, but not every issue is a pull request.

                                                                                                          This endpoint may also return pull requests in the response. If an issue is a pull request, the object will include a pull_request key.

                                                                                                          GET /repos/:owner/:repo/issues/:number
                                                                                                          

                                                                                                          Response

                                                                                                          Status: 200 OK
                                                                                                          
                                                                                                          {
                                                                                                            "id": 1,
                                                                                                            "url": "https://api.github.com/repos/octocat/Hello-World/issues/1347",
                                                                                                            "repository_url": "https://api.github.com/repos/octocat/Hello-World",
                                                                                                            "labels_url": "https://api.github.com/repos/octocat/Hello-World/issues/1347/labels{/name}",
                                                                                                            "comments_url": "https://api.github.com/repos/octocat/Hello-World/issues/1347/comments",
                                                                                                            "events_url": "https://api.github.com/repos/octocat/Hello-World/issues/1347/events",
                                                                                                            "html_url": "https://github.com/octocat/Hello-World/issues/1347",
                                                                                                            "number": 1347,
                                                                                                            "state": "open",
                                                                                                            "title": "Found a bug",
                                                                                                            "body": "I'm having a problem with this.",
                                                                                                            "user": {
                                                                                                              "login": "octocat",
                                                                                                              "id": 1,
                                                                                                              "avatar_url": "https://github.com/images/error/octocat_happy.gif",
                                                                                                              "gravatar_id": "",
                                                                                                              "url": "https://api.github.com/users/octocat",
                                                                                                              "html_url": "https://github.com/octocat",
                                                                                                              "followers_url": "https://api.github.com/users/octocat/followers",
                                                                                                              "following_url": "https://api.github.com/users/octocat/following{/other_user}",
                                                                                                              "gists_url": "https://api.github.com/users/octocat/gists{/gist_id}",
                                                                                                              "starred_url": "https://api.github.com/users/octocat/starred{/owner}{/repo}",
                                                                                                              "subscriptions_url": "https://api.github.com/users/octocat/subscriptions",
                                                                                                              "organizations_url": "https://api.github.com/users/octocat/orgs",
                                                                                                              "repos_url": "https://api.github.com/users/octocat/repos",
                                                                                                              "events_url": "https://api.github.com/users/octocat/events{/privacy}",
                                                                                                              "received_events_url": "https://api.github.com/users/octocat/received_events",
                                                                                                              "type": "User",
                                                                                                              "site_admin": false
                                                                                                            },
                                                                                                            "labels": [
                                                                                                              {
                                                                                                                "id": 208045946,
                                                                                                                "url": "https://api.github.com/repos/octocat/Hello-World/labels/bug",
                                                                                                                "name": "bug",
                                                                                                                "color": "f29513",
                                                                                                                "default": true
                                                                                                              }
                                                                                                            ],
                                                                                                            "assignee": {
                                                                                                              "login": "octocat",
                                                                                                              "id": 1,
                                                                                                              "avatar_url": "https://github.com/images/error/octocat_happy.gif",
                                                                                                              "gravatar_id": "",
                                                                                                              "url": "https://api.github.com/users/octocat",
                                                                                                              "html_url": "https://github.com/octocat",
                                                                                                              "followers_url": "https://api.github.com/users/octocat/followers",
                                                                                                              "following_url": "https://api.github.com/users/octocat/following{/other_user}",
                                                                                                              "gists_url": "https://api.github.com/users/octocat/gists{/gist_id}",
                                                                                                              "starred_url": "https://api.github.com/users/octocat/starred{/owner}{/repo}",
                                                                                                              "subscriptions_url": "https://api.github.com/users/octocat/subscriptions",
                                                                                                              "organizations_url": "https://api.github.com/users/octocat/orgs",
                                                                                                              "repos_url": "https://api.github.com/users/octocat/repos",
                                                                                                              "events_url": "https://api.github.com/users/octocat/events{/privacy}",
                                                                                                              "received_events_url": "https://api.github.com/users/octocat/received_events",
                                                                                                              "type": "User",
                                                                                                              "site_admin": false
                                                                                                            },
                                                                                                            "assignees": [
                                                                                                              {
                                                                                                                "login": "octocat",
                                                                                                                "id": 1,
                                                                                                                "avatar_url": "https://github.com/images/error/octocat_happy.gif",
                                                                                                                "gravatar_id": "",
                                                                                                                "url": "https://api.github.com/users/octocat",
                                                                                                                "html_url": "https://github.com/octocat",
                                                                                                                "followers_url": "https://api.github.com/users/octocat/followers",
                                                                                                                "following_url": "https://api.github.com/users/octocat/following{/other_user}",
                                                                                                                "gists_url": "https://api.github.com/users/octocat/gists{/gist_id}",
                                                                                                                "starred_url": "https://api.github.com/users/octocat/starred{/owner}{/repo}",
                                                                                                                "subscriptions_url": "https://api.github.com/users/octocat/subscriptions",
                                                                                                                "organizations_url": "https://api.github.com/users/octocat/orgs",
                                                                                                                "repos_url": "https://api.github.com/users/octocat/repos",
                                                                                                                "events_url": "https://api.github.com/users/octocat/events{/privacy}",
                                                                                                                "received_events_url": "https://api.github.com/users/octocat/received_events",
                                                                                                                "type": "User",
                                                                                                                "site_admin": false
                                                                                                              }
                                                                                                            ],
                                                                                                            "milestone": {
                                                                                                              "url": "https://api.github.com/repos/octocat/Hello-World/milestones/1",
                                                                                                              "html_url": "https://github.com/octocat/Hello-World/milestones/v1.0",
                                                                                                              "labels_url": "https://api.github.com/repos/octocat/Hello-World/milestones/1/labels",
                                                                                                              "id": 1002604,
                                                                                                              "number": 1,
                                                                                                              "state": "open",
                                                                                                              "title": "v1.0",
                                                                                                              "description": "Tracking milestone for version 1.0",
                                                                                                              "creator": {
                                                                                                                "login": "octocat",
                                                                                                                "id": 1,
                                                                                                                "avatar_url": "https://github.com/images/error/octocat_happy.gif",
                                                                                                                "gravatar_id": "",
                                                                                                                "url": "https://api.github.com/users/octocat",
                                                                                                                "html_url": "https://github.com/octocat",
                                                                                                                "followers_url": "https://api.github.com/users/octocat/followers",
                                                                                                                "following_url": "https://api.github.com/users/octocat/following{/other_user}",
                                                                                                                "gists_url": "https://api.github.com/users/octocat/gists{/gist_id}",
                                                                                                                "starred_url": "https://api.github.com/users/octocat/starred{/owner}{/repo}",
                                                                                                                "subscriptions_url": "https://api.github.com/users/octocat/subscriptions",
                                                                                                                "organizations_url": "https://api.github.com/users/octocat/orgs",
                                                                                                                "repos_url": "https://api.github.com/users/octocat/repos",
                                                                                                                "events_url": "https://api.github.com/users/octocat/events{/privacy}",
                                                                                                                "received_events_url": "https://api.github.com/users/octocat/received_events",
                                                                                                                "type": "User",
                                                                                                                "site_admin": false
                                                                                                              },
                                                                                                              "open_issues": 4,
                                                                                                              "closed_issues": 8,
                                                                                                              "created_at": "2011-04-10T20:09:31Z",
                                                                                                              "updated_at": "2014-03-03T18:58:10Z",
                                                                                                              "closed_at": "2013-02-12T13:22:01Z",
                                                                                                              "due_on": "2012-10-09T23:39:01Z"
                                                                                                            },
                                                                                                            "locked": true,
                                                                                                            "active_lock_reason": "too heated",
                                                                                                            "comments": 0,
                                                                                                            "pull_request": {
                                                                                                              "url": "https://api.github.com/repos/octocat/Hello-World/pulls/1347",
                                                                                                              "html_url": "https://github.com/octocat/Hello-World/pull/1347",
                                                                                                              "diff_url": "https://github.com/octocat/Hello-World/pull/1347.diff",
                                                                                                              "patch_url": "https://github.com/octocat/Hello-World/pull/1347.patch"
                                                                                                            },
                                                                                                            "closed_at": null,
                                                                                                            "created_at": "2011-04-22T13:33:48Z",
                                                                                                            "updated_at": "2011-04-22T13:33:48Z",
                                                                                                            "closed_by": {
                                                                                                              "login": "octocat",
                                                                                                              "id": 1,
                                                                                                              "avatar_url": "https://github.com/images/error/octocat_happy.gif",
                                                                                                              "gravatar_id": "",
                                                                                                              "url": "https://api.github.com/users/octocat",
                                                                                                              "html_url": "https://github.com/octocat",
                                                                                                              "followers_url": "https://api.github.com/users/octocat/followers",
                                                                                                              "following_url": "https://api.github.com/users/octocat/following{/other_user}",
                                                                                                              "gists_url": "https://api.github.com/users/octocat/gists{/gist_id}",
                                                                                                              "starred_url": "https://api.github.com/users/octocat/starred{/owner}{/repo}",
                                                                                                              "subscriptions_url": "https://api.github.com/users/octocat/subscriptions",
                                                                                                              "organizations_url": "https://api.github.com/users/octocat/orgs",
                                                                                                              "repos_url": "https://api.github.com/users/octocat/repos",
                                                                                                              "events_url": "https://api.github.com/users/octocat/events{/privacy}",
                                                                                                              "received_events_url": "https://api.github.com/users/octocat/received_events",
                                                                                                              "type": "User",
                                                                                                              "site_admin": false
                                                                                                            }
                                                                                                          }
                                                                                                          

                                                                                                          Reactions summary

                                                                                                          An additional reactions object in the issue payload is currently available for developers to preview. During the preview period, the APIs may change without advance notice. Please see the blog post for full details.

                                                                                                          To access the API you must provide a custom media type in the Accept header:

                                                                                                            application/vnd.github.squirrel-girl-preview
                                                                                                          

                                                                                                          The reactions key will have the following payload where url can be used to construct the API location for listing and creating reactions.

                                                                                                          {
                                                                                                            "total_count": 5,
                                                                                                            "+1": 3,
                                                                                                            "-1": 1,
                                                                                                            "laugh": 0,
                                                                                                            "confused": 0,
                                                                                                            "heart": 1,
                                                                                                            "hooray": 0,
                                                                                                            "url": "https://api.github.com/repos/octocat/Hello-World/issues/1347/reactions"
                                                                                                          }
                                                                                                          

                                                                                                          Create an issue

                                                                                                          Any user with pull access to a repository can create an issue.

                                                                                                          POST /repos/:owner/:repo/issues
                                                                                                          

                                                                                                          Parameters

                                                                                                          Name Type Description
                                                                                                          title string Required. The title of the issue.
                                                                                                          body string The contents of the issue.
                                                                                                          assignee string Login for the user that this issue should be assigned to. NOTE: Only users with push access can set the assignee for new issues. The assignee is silently dropped otherwise. This field is deprecated.
                                                                                                          milestone integer The number of the milestone to associate this issue with. NOTE: Only users with push access can set the milestone for new issues. The milestone is silently dropped otherwise.
                                                                                                          labels array of strings Labels to associate with this issue. NOTE: Only users with push access can set labels for new issues. Labels are silently dropped otherwise.
                                                                                                          assignees array of strings Logins for Users to assign to this issue. NOTE: Only users with push access can set assignees for new issues. Assignees are silently dropped otherwise.

                                                                                                          Example

                                                                                                          {
                                                                                                            "title": "Found a bug",
                                                                                                            "body": "I'm having a problem with this.",
                                                                                                            "assignees": [
                                                                                                              "octocat"
                                                                                                            ],
                                                                                                            "milestone": 1,
                                                                                                            "labels": [
                                                                                                              "bug"
                                                                                                            ]
                                                                                                          }
                                                                                                          

                                                                                                          Response

                                                                                                          Status: 201 Created
                                                                                                          Location: https://api.github.com/repos/octocat/Hello-World/issues/1347
                                                                                                          
                                                                                                          {
                                                                                                            "id": 1,
                                                                                                            "url": "https://api.github.com/repos/octocat/Hello-World/issues/1347",
                                                                                                            "repository_url": "https://api.github.com/repos/octocat/Hello-World",
                                                                                                            "labels_url": "https://api.github.com/repos/octocat/Hello-World/issues/1347/labels{/name}",
                                                                                                            "comments_url": "https://api.github.com/repos/octocat/Hello-World/issues/1347/comments",
                                                                                                            "events_url": "https://api.github.com/repos/octocat/Hello-World/issues/1347/events",
                                                                                                            "html_url": "https://github.com/octocat/Hello-World/issues/1347",
                                                                                                            "number": 1347,
                                                                                                            "state": "open",
                                                                                                            "title": "Found a bug",
                                                                                                            "body": "I'm having a problem with this.",
                                                                                                            "user": {
                                                                                                              "login": "octocat",
                                                                                                              "id": 1,
                                                                                                              "avatar_url": "https://github.com/images/error/octocat_happy.gif",
                                                                                                              "gravatar_id": "",
                                                                                                              "url": "https://api.github.com/users/octocat",
                                                                                                              "html_url": "https://github.com/octocat",
                                                                                                              "followers_url": "https://api.github.com/users/octocat/followers",
                                                                                                              "following_url": "https://api.github.com/users/octocat/following{/other_user}",
                                                                                                              "gists_url": "https://api.github.com/users/octocat/gists{/gist_id}",
                                                                                                              "starred_url": "https://api.github.com/users/octocat/starred{/owner}{/repo}",
                                                                                                              "subscriptions_url": "https://api.github.com/users/octocat/subscriptions",
                                                                                                              "organizations_url": "https://api.github.com/users/octocat/orgs",
                                                                                                              "repos_url": "https://api.github.com/users/octocat/repos",
                                                                                                              "events_url": "https://api.github.com/users/octocat/events{/privacy}",
                                                                                                              "received_events_url": "https://api.github.com/users/octocat/received_events",
                                                                                                              "type": "User",
                                                                                                              "site_admin": false
                                                                                                            },
                                                                                                            "labels": [
                                                                                                              {
                                                                                                                "id": 208045946,
                                                                                                                "url": "https://api.github.com/repos/octocat/Hello-World/labels/bug",
                                                                                                                "name": "bug",
                                                                                                                "color": "f29513",
                                                                                                                "default": true
                                                                                                              }
                                                                                                            ],
                                                                                                            "assignee": {
                                                                                                              "login": "octocat",
                                                                                                              "id": 1,
                                                                                                              "avatar_url": "https://github.com/images/error/octocat_happy.gif",
                                                                                                              "gravatar_id": "",
                                                                                                              "url": "https://api.github.com/users/octocat",
                                                                                                              "html_url": "https://github.com/octocat",
                                                                                                              "followers_url": "https://api.github.com/users/octocat/followers",
                                                                                                              "following_url": "https://api.github.com/users/octocat/following{/other_user}",
                                                                                                              "gists_url": "https://api.github.com/users/octocat/gists{/gist_id}",
                                                                                                              "starred_url": "https://api.github.com/users/octocat/starred{/owner}{/repo}",
                                                                                                              "subscriptions_url": "https://api.github.com/users/octocat/subscriptions",
                                                                                                              "organizations_url": "https://api.github.com/users/octocat/orgs",
                                                                                                              "repos_url": "https://api.github.com/users/octocat/repos",
                                                                                                              "events_url": "https://api.github.com/users/octocat/events{/privacy}",
                                                                                                              "received_events_url": "https://api.github.com/users/octocat/received_events",
                                                                                                              "type": "User",
                                                                                                              "site_admin": false
                                                                                                            },
                                                                                                            "assignees": [
                                                                                                              {
                                                                                                                "login": "octocat",
                                                                                                                "id": 1,
                                                                                                                "avatar_url": "https://github.com/images/error/octocat_happy.gif",
                                                                                                                "gravatar_id": "",
                                                                                                                "url": "https://api.github.com/users/octocat",
                                                                                                                "html_url": "https://github.com/octocat",
                                                                                                                "followers_url": "https://api.github.com/users/octocat/followers",
                                                                                                                "following_url": "https://api.github.com/users/octocat/following{/other_user}",
                                                                                                                "gists_url": "https://api.github.com/users/octocat/gists{/gist_id}",
                                                                                                                "starred_url": "https://api.github.com/users/octocat/starred{/owner}{/repo}",
                                                                                                                "subscriptions_url": "https://api.github.com/users/octocat/subscriptions",
                                                                                                                "organizations_url": "https://api.github.com/users/octocat/orgs",
                                                                                                                "repos_url": "https://api.github.com/users/octocat/repos",
                                                                                                                "events_url": "https://api.github.com/users/octocat/events{/privacy}",
                                                                                                                "received_events_url": "https://api.github.com/users/octocat/received_events",
                                                                                                                "type": "User",
                                                                                                                "site_admin": false
                                                                                                              }
                                                                                                            ],
                                                                                                            "milestone": {
                                                                                                              "url": "https://api.github.com/repos/octocat/Hello-World/milestones/1",
                                                                                                              "html_url": "https://github.com/octocat/Hello-World/milestones/v1.0",
                                                                                                              "labels_url": "https://api.github.com/repos/octocat/Hello-World/milestones/1/labels",
                                                                                                              "id": 1002604,
                                                                                                              "number": 1,
                                                                                                              "state": "open",
                                                                                                              "title": "v1.0",
                                                                                                              "description": "Tracking milestone for version 1.0",
                                                                                                              "creator": {
                                                                                                                "login": "octocat",
                                                                                                                "id": 1,
                                                                                                                "avatar_url": "https://github.com/images/error/octocat_happy.gif",
                                                                                                                "gravatar_id": "",
                                                                                                                "url": "https://api.github.com/users/octocat",
                                                                                                                "html_url": "https://github.com/octocat",
                                                                                                                "followers_url": "https://api.github.com/users/octocat/followers",
                                                                                                                "following_url": "https://api.github.com/users/octocat/following{/other_user}",
                                                                                                                "gists_url": "https://api.github.com/users/octocat/gists{/gist_id}",
                                                                                                                "starred_url": "https://api.github.com/users/octocat/starred{/owner}{/repo}",
                                                                                                                "subscriptions_url": "https://api.github.com/users/octocat/subscriptions",
                                                                                                                "organizations_url": "https://api.github.com/users/octocat/orgs",
                                                                                                                "repos_url": "https://api.github.com/users/octocat/repos",
                                                                                                                "events_url": "https://api.github.com/users/octocat/events{/privacy}",
                                                                                                                "received_events_url": "https://api.github.com/users/octocat/received_events",
                                                                                                                "type": "User",
                                                                                                                "site_admin": false
                                                                                                              },
                                                                                                              "open_issues": 4,
                                                                                                              "closed_issues": 8,
                                                                                                              "created_at": "2011-04-10T20:09:31Z",
                                                                                                              "updated_at": "2014-03-03T18:58:10Z",
                                                                                                              "closed_at": "2013-02-12T13:22:01Z",
                                                                                                              "due_on": "2012-10-09T23:39:01Z"
                                                                                                            },
                                                                                                            "locked": true,
                                                                                                            "active_lock_reason": "too heated",
                                                                                                            "comments": 0,
                                                                                                            "pull_request": {
                                                                                                              "url": "https://api.github.com/repos/octocat/Hello-World/pulls/1347",
                                                                                                              "html_url": "https://github.com/octocat/Hello-World/pull/1347",
                                                                                                              "diff_url": "https://github.com/octocat/Hello-World/pull/1347.diff",
                                                                                                              "patch_url": "https://github.com/octocat/Hello-World/pull/1347.patch"
                                                                                                            },
                                                                                                            "closed_at": null,
                                                                                                            "created_at": "2011-04-22T13:33:48Z",
                                                                                                            "updated_at": "2011-04-22T13:33:48Z",
                                                                                                            "closed_by": {
                                                                                                              "login": "octocat",
                                                                                                              "id": 1,
                                                                                                              "avatar_url": "https://github.com/images/error/octocat_happy.gif",
                                                                                                              "gravatar_id": "",
                                                                                                              "url": "https://api.github.com/users/octocat",
                                                                                                              "html_url": "https://github.com/octocat",
                                                                                                              "followers_url": "https://api.github.com/users/octocat/followers",
                                                                                                              "following_url": "https://api.github.com/users/octocat/following{/other_user}",
                                                                                                              "gists_url": "https://api.github.com/users/octocat/gists{/gist_id}",
                                                                                                              "starred_url": "https://api.github.com/users/octocat/starred{/owner}{/repo}",
                                                                                                              "subscriptions_url": "https://api.github.com/users/octocat/subscriptions",
                                                                                                              "organizations_url": "https://api.github.com/users/octocat/orgs",
                                                                                                              "repos_url": "https://api.github.com/users/octocat/repos",
                                                                                                              "events_url": "https://api.github.com/users/octocat/events{/privacy}",
                                                                                                              "received_events_url": "https://api.github.com/users/octocat/received_events",
                                                                                                              "type": "User",
                                                                                                              "site_admin": false
                                                                                                            }
                                                                                                          }
                                                                                                          

                                                                                                          Edit an issue

                                                                                                          Issue owners and users with push access can edit an issue.

                                                                                                          PATCH /repos/:owner/:repo/issues/:number
                                                                                                          

                                                                                                          Parameters

                                                                                                          Name Type Description
                                                                                                          title string The title of the issue.
                                                                                                          body string The contents of the issue.
                                                                                                          assignee string Login for the user that this issue should be assigned to. This field is deprecated.
                                                                                                          state string State of the issue. Either open or closed.
                                                                                                          milestone integer The number of the milestone to associate this issue with or null to remove current. NOTE: Only users with push access can set the milestone for issues. The milestone is silently dropped otherwise.
                                                                                                          labels array of strings Labels to associate with this issue. Pass one or more Labels to replace the set of Labels on this Issue. Send an empty array ([]) to clear all Labels from the Issue. NOTE: Only users with push access can set labels for issues. Labels are silently dropped otherwise.
                                                                                                          assignees array of strings Logins for Users to assign to this issue. Pass one or more user logins to replace the set of assignees on this Issue. Send an empty array ([]) to clear all assignees from the Issue. NOTE: Only users with push access can set assignees for new issues. Assignees are silently dropped otherwise.

                                                                                                          Example

                                                                                                          {
                                                                                                            "title": "Found a bug",
                                                                                                            "body": "I'm having a problem with this.",
                                                                                                            "assignees": [
                                                                                                              "octocat"
                                                                                                            ],
                                                                                                            "milestone": 1,
                                                                                                            "state": "open",
                                                                                                            "labels": [
                                                                                                              "bug"
                                                                                                            ]
                                                                                                          }
                                                                                                          

                                                                                                          Response

                                                                                                          Status: 200 OK
                                                                                                          
                                                                                                          {
                                                                                                            "id": 1,
                                                                                                            "url": "https://api.github.com/repos/octocat/Hello-World/issues/1347",
                                                                                                            "repository_url": "https://api.github.com/repos/octocat/Hello-World",
                                                                                                            "labels_url": "https://api.github.com/repos/octocat/Hello-World/issues/1347/labels{/name}",
                                                                                                            "comments_url": "https://api.github.com/repos/octocat/Hello-World/issues/1347/comments",
                                                                                                            "events_url": "https://api.github.com/repos/octocat/Hello-World/issues/1347/events",
                                                                                                            "html_url": "https://github.com/octocat/Hello-World/issues/1347",
                                                                                                            "number": 1347,
                                                                                                            "state": "open",
                                                                                                            "title": "Found a bug",
                                                                                                            "body": "I'm having a problem with this.",
                                                                                                            "user": {
                                                                                                              "login": "octocat",
                                                                                                              "id": 1,
                                                                                                              "avatar_url": "https://github.com/images/error/octocat_happy.gif",
                                                                                                              "gravatar_id": "",
                                                                                                              "url": "https://api.github.com/users/octocat",
                                                                                                              "html_url": "https://github.com/octocat",
                                                                                                              "followers_url": "https://api.github.com/users/octocat/followers",
                                                                                                              "following_url": "https://api.github.com/users/octocat/following{/other_user}",
                                                                                                              "gists_url": "https://api.github.com/users/octocat/gists{/gist_id}",
                                                                                                              "starred_url": "https://api.github.com/users/octocat/starred{/owner}{/repo}",
                                                                                                              "subscriptions_url": "https://api.github.com/users/octocat/subscriptions",
                                                                                                              "organizations_url": "https://api.github.com/users/octocat/orgs",
                                                                                                              "repos_url": "https://api.github.com/users/octocat/repos",
                                                                                                              "events_url": "https://api.github.com/users/octocat/events{/privacy}",
                                                                                                              "received_events_url": "https://api.github.com/users/octocat/received_events",
                                                                                                              "type": "User",
                                                                                                              "site_admin": false
                                                                                                            },
                                                                                                            "labels": [
                                                                                                              {
                                                                                                                "id": 208045946,
                                                                                                                "url": "https://api.github.com/repos/octocat/Hello-World/labels/bug",
                                                                                                                "name": "bug",
                                                                                                                "color": "f29513",
                                                                                                                "default": true
                                                                                                              }
                                                                                                            ],
                                                                                                            "assignee": {
                                                                                                              "login": "octocat",
                                                                                                              "id": 1,
                                                                                                              "avatar_url": "https://github.com/images/error/octocat_happy.gif",
                                                                                                              "gravatar_id": "",
                                                                                                              "url": "https://api.github.com/users/octocat",
                                                                                                              "html_url": "https://github.com/octocat",
                                                                                                              "followers_url": "https://api.github.com/users/octocat/followers",
                                                                                                              "following_url": "https://api.github.com/users/octocat/following{/other_user}",
                                                                                                              "gists_url": "https://api.github.com/users/octocat/gists{/gist_id}",
                                                                                                              "starred_url": "https://api.github.com/users/octocat/starred{/owner}{/repo}",
                                                                                                              "subscriptions_url": "https://api.github.com/users/octocat/subscriptions",
                                                                                                              "organizations_url": "https://api.github.com/users/octocat/orgs",
                                                                                                              "repos_url": "https://api.github.com/users/octocat/repos",
                                                                                                              "events_url": "https://api.github.com/users/octocat/events{/privacy}",
                                                                                                              "received_events_url": "https://api.github.com/users/octocat/received_events",
                                                                                                              "type": "User",
                                                                                                              "site_admin": false
                                                                                                            },
                                                                                                            "assignees": [
                                                                                                              {
                                                                                                                "login": "octocat",
                                                                                                                "id": 1,
                                                                                                                "avatar_url": "https://github.com/images/error/octocat_happy.gif",
                                                                                                                "gravatar_id": "",
                                                                                                                "url": "https://api.github.com/users/octocat",
                                                                                                                "html_url": "https://github.com/octocat",
                                                                                                                "followers_url": "https://api.github.com/users/octocat/followers",
                                                                                                                "following_url": "https://api.github.com/users/octocat/following{/other_user}",
                                                                                                                "gists_url": "https://api.github.com/users/octocat/gists{/gist_id}",
                                                                                                                "starred_url": "https://api.github.com/users/octocat/starred{/owner}{/repo}",
                                                                                                                "subscriptions_url": "https://api.github.com/users/octocat/subscriptions",
                                                                                                                "organizations_url": "https://api.github.com/users/octocat/orgs",
                                                                                                                "repos_url": "https://api.github.com/users/octocat/repos",
                                                                                                                "events_url": "https://api.github.com/users/octocat/events{/privacy}",
                                                                                                                "received_events_url": "https://api.github.com/users/octocat/received_events",
                                                                                                                "type": "User",
                                                                                                                "site_admin": false
                                                                                                              }
                                                                                                            ],
                                                                                                            "milestone": {
                                                                                                              "url": "https://api.github.com/repos/octocat/Hello-World/milestones/1",
                                                                                                              "html_url": "https://github.com/octocat/Hello-World/milestones/v1.0",
                                                                                                              "labels_url": "https://api.github.com/repos/octocat/Hello-World/milestones/1/labels",
                                                                                                              "id": 1002604,
                                                                                                              "number": 1,
                                                                                                              "state": "open",
                                                                                                              "title": "v1.0",
                                                                                                              "description": "Tracking milestone for version 1.0",
                                                                                                              "creator": {
                                                                                                                "login": "octocat",
                                                                                                                "id": 1,
                                                                                                                "avatar_url": "https://github.com/images/error/octocat_happy.gif",
                                                                                                                "gravatar_id": "",
                                                                                                                "url": "https://api.github.com/users/octocat",
                                                                                                                "html_url": "https://github.com/octocat",
                                                                                                                "followers_url": "https://api.github.com/users/octocat/followers",
                                                                                                                "following_url": "https://api.github.com/users/octocat/following{/other_user}",
                                                                                                                "gists_url": "https://api.github.com/users/octocat/gists{/gist_id}",
                                                                                                                "starred_url": "https://api.github.com/users/octocat/starred{/owner}{/repo}",
                                                                                                                "subscriptions_url": "https://api.github.com/users/octocat/subscriptions",
                                                                                                                "organizations_url": "https://api.github.com/users/octocat/orgs",
                                                                                                                "repos_url": "https://api.github.com/users/octocat/repos",
                                                                                                                "events_url": "https://api.github.com/users/octocat/events{/privacy}",
                                                                                                                "received_events_url": "https://api.github.com/users/octocat/received_events",
                                                                                                                "type": "User",
                                                                                                                "site_admin": false
                                                                                                              },
                                                                                                              "open_issues": 4,
                                                                                                              "closed_issues": 8,
                                                                                                              "created_at": "2011-04-10T20:09:31Z",
                                                                                                              "updated_at": "2014-03-03T18:58:10Z",
                                                                                                              "closed_at": "2013-02-12T13:22:01Z",
                                                                                                              "due_on": "2012-10-09T23:39:01Z"
                                                                                                            },
                                                                                                            "locked": true,
                                                                                                            "active_lock_reason": "too heated",
                                                                                                            "comments": 0,
                                                                                                            "pull_request": {
                                                                                                              "url": "https://api.github.com/repos/octocat/Hello-World/pulls/1347",
                                                                                                              "html_url": "https://github.com/octocat/Hello-World/pull/1347",
                                                                                                              "diff_url": "https://github.com/octocat/Hello-World/pull/1347.diff",
                                                                                                              "patch_url": "https://github.com/octocat/Hello-World/pull/1347.patch"
                                                                                                            },
                                                                                                            "closed_at": null,
                                                                                                            "created_at": "2011-04-22T13:33:48Z",
                                                                                                            "updated_at": "2011-04-22T13:33:48Z",
                                                                                                            "closed_by": {
                                                                                                              "login": "octocat",
                                                                                                              "id": 1,
                                                                                                              "avatar_url": "https://github.com/images/error/octocat_happy.gif",
                                                                                                              "gravatar_id": "",
                                                                                                              "url": "https://api.github.com/users/octocat",
                                                                                                              "html_url": "https://github.com/octocat",
                                                                                                              "followers_url": "https://api.github.com/users/octocat/followers",
                                                                                                              "following_url": "https://api.github.com/users/octocat/following{/other_user}",
                                                                                                              "gists_url": "https://api.github.com/users/octocat/gists{/gist_id}",
                                                                                                              "starred_url": "https://api.github.com/users/octocat/starred{/owner}{/repo}",
                                                                                                              "subscriptions_url": "https://api.github.com/users/octocat/subscriptions",
                                                                                                              "organizations_url": "https://api.github.com/users/octocat/orgs",
                                                                                                              "repos_url": "https://api.github.com/users/octocat/repos",
                                                                                                              "events_url": "https://api.github.com/users/octocat/events{/privacy}",
                                                                                                              "received_events_url": "https://api.github.com/users/octocat/received_events",
                                                                                                              "type": "User",
                                                                                                              "site_admin": false
                                                                                                            }
                                                                                                          }
                                                                                                          

                                                                                                          Lock an issue

                                                                                                          Note: You can now add a reason when you lock an issue. This feature is currently available for developers to preview. See the blog post for full details. To access this feature, you must provide a custom media type in the Accept header:

                                                                                                          application/vnd.github.sailor-v-preview+json
                                                                                                          

                                                                                                          Warning: The API may change without advance notice during the preview period. Preview features are not supported for production use. If you experience any issues, contact GitHub support.

                                                                                                          Users with push access can lock an issue or pull request's conversation.

                                                                                                          PUT /repos/:owner/:repo/issues/:number/lock
                                                                                                          

                                                                                                          Note that, if you choose not to pass any parameters, you'll need to set Content-Length to zero when calling out to this endpoint. For more information, see "HTTP verbs."

                                                                                                          Parameters

                                                                                                          You can add a publicly visible lock reason when you lock a conversation.

                                                                                                          Name Type Description
                                                                                                          lock_reason string The reason for locking the issue or pull request conversation. Lock will fail if you don't use one of these reasons:
                                                                                                          * off-topic
                                                                                                          * too heated
                                                                                                          * resolved
                                                                                                          * spam

                                                                                                          Example

                                                                                                          {
                                                                                                            "locked": true,
                                                                                                            "active_lock_reason": "too heated"
                                                                                                          }
                                                                                                          

                                                                                                          Response

                                                                                                          Status: 204 No Content
                                                                                                          

                                                                                                          Unlock an issue

                                                                                                          Users with push access can unlock an issue's conversation.

                                                                                                          DELETE /repos/:owner/:repo/issues/:number/lock
                                                                                                          

                                                                                                          Response

                                                                                                          Status: 204 No Content
                                                                                                          

                                                                                                          Custom media types

                                                                                                          These are the supported media types for issues. You can read more about the use of media types in the API here.

                                                                                                          application/vnd.github.VERSION.raw+json
                                                                                                          application/vnd.github.VERSION.text+json
                                                                                                          application/vnd.github.VERSION.html+json
                                                                                                          application/vnd.github.VERSION.full+json
                                                                                                          
                                                                                                          tmp/developer.github.com/v3/issues/assignees/index.html Issue Assignees | GitHub Developer Guide

                                                                                                          Assignees

                                                                                                          List assignees

                                                                                                          Lists the available assignees for issues in a repository.

                                                                                                          GET /repos/:owner/:repo/assignees
                                                                                                          

                                                                                                          Response

                                                                                                          Status: 200 OK
                                                                                                          Link: <https://api.github.com/resource?page=2>; rel="next",
                                                                                                                <https://api.github.com/resource?page=5>; rel="last"
                                                                                                          
                                                                                                          [
                                                                                                            {
                                                                                                              "login": "octocat",
                                                                                                              "id": 1,
                                                                                                              "avatar_url": "https://github.com/images/error/octocat_happy.gif",
                                                                                                              "gravatar_id": "",
                                                                                                              "url": "https://api.github.com/users/octocat",
                                                                                                              "html_url": "https://github.com/octocat",
                                                                                                              "followers_url": "https://api.github.com/users/octocat/followers",
                                                                                                              "following_url": "https://api.github.com/users/octocat/following{/other_user}",
                                                                                                              "gists_url": "https://api.github.com/users/octocat/gists{/gist_id}",
                                                                                                              "starred_url": "https://api.github.com/users/octocat/starred{/owner}{/repo}",
                                                                                                              "subscriptions_url": "https://api.github.com/users/octocat/subscriptions",
                                                                                                              "organizations_url": "https://api.github.com/users/octocat/orgs",
                                                                                                              "repos_url": "https://api.github.com/users/octocat/repos",
                                                                                                              "events_url": "https://api.github.com/users/octocat/events{/privacy}",
                                                                                                              "received_events_url": "https://api.github.com/users/octocat/received_events",
                                                                                                              "type": "User",
                                                                                                              "site_admin": false
                                                                                                            }
                                                                                                          ]
                                                                                                          

                                                                                                          Check assignee

                                                                                                          Checks if a user has permission to be assigned to an issue in this repository.

                                                                                                          GET /repos/:owner/:repo/assignees/:assignee
                                                                                                          

                                                                                                          Response

                                                                                                          If the assignee can be assigned to issues in the repository, a 204 header with no content is returned.

                                                                                                          Status: 204 No Content
                                                                                                          

                                                                                                          Otherwise a 404 status code is returned.

                                                                                                          Status: 404 Not Found
                                                                                                          

                                                                                                          Add assignees to an issue

                                                                                                          Adds up to 10 assignees to an issue. Users already assigned to an issue are not replaced.

                                                                                                          POST /repos/:owner/:repo/issues/:number/assignees
                                                                                                          

                                                                                                          Parameters

                                                                                                          Name Type Description
                                                                                                          assignees array of strings Usernames of people to assign this issue to. NOTE: Only users with push access can add assignees to an issue. Assignees are silently ignored otherwise.

                                                                                                          Example

                                                                                                          This example adds two assignees to the existing octocat assignee.

                                                                                                          {
                                                                                                            "assignees": [
                                                                                                              "hubot",
                                                                                                              "other_user"
                                                                                                            ]
                                                                                                          }
                                                                                                          

                                                                                                          Response

                                                                                                          Status: 201 Created
                                                                                                          
                                                                                                          {
                                                                                                            "id": 1,
                                                                                                            "url": "https://api.github.com/repos/octocat/Hello-World/issues/1347",
                                                                                                            "repository_url": "https://api.github.com/repos/octocat/Hello-World",
                                                                                                            "labels_url": "https://api.github.com/repos/octocat/Hello-World/issues/1347/labels{/name}",
                                                                                                            "comments_url": "https://api.github.com/repos/octocat/Hello-World/issues/1347/comments",
                                                                                                            "events_url": "https://api.github.com/repos/octocat/Hello-World/issues/1347/events",
                                                                                                            "html_url": "https://github.com/octocat/Hello-World/issues/1347",
                                                                                                            "number": 1347,
                                                                                                            "state": "open",
                                                                                                            "title": "Found a bug",
                                                                                                            "body": "I'm having a problem with this.",
                                                                                                            "user": {
                                                                                                              "login": "octocat",
                                                                                                              "id": 1,
                                                                                                              "avatar_url": "https://github.com/images/error/octocat_happy.gif",
                                                                                                              "gravatar_id": "",
                                                                                                              "url": "https://api.github.com/users/octocat",
                                                                                                              "html_url": "https://github.com/octocat",
                                                                                                              "followers_url": "https://api.github.com/users/octocat/followers",
                                                                                                              "following_url": "https://api.github.com/users/octocat/following{/other_user}",
                                                                                                              "gists_url": "https://api.github.com/users/octocat/gists{/gist_id}",
                                                                                                              "starred_url": "https://api.github.com/users/octocat/starred{/owner}{/repo}",
                                                                                                              "subscriptions_url": "https://api.github.com/users/octocat/subscriptions",
                                                                                                              "organizations_url": "https://api.github.com/users/octocat/orgs",
                                                                                                              "repos_url": "https://api.github.com/users/octocat/repos",
                                                                                                              "events_url": "https://api.github.com/users/octocat/events{/privacy}",
                                                                                                              "received_events_url": "https://api.github.com/users/octocat/received_events",
                                                                                                              "type": "User",
                                                                                                              "site_admin": false
                                                                                                            },
                                                                                                            "labels": [
                                                                                                              {
                                                                                                                "id": 208045946,
                                                                                                                "url": "https://api.github.com/repos/octocat/Hello-World/labels/bug",
                                                                                                                "name": "bug",
                                                                                                                "color": "f29513",
                                                                                                                "default": true
                                                                                                              }
                                                                                                            ],
                                                                                                            "assignee": {
                                                                                                              "login": "octocat",
                                                                                                              "id": 1,
                                                                                                              "avatar_url": "https://github.com/images/error/octocat_happy.gif",
                                                                                                              "gravatar_id": "",
                                                                                                              "url": "https://api.github.com/users/octocat",
                                                                                                              "html_url": "https://github.com/octocat",
                                                                                                              "followers_url": "https://api.github.com/users/octocat/followers",
                                                                                                              "following_url": "https://api.github.com/users/octocat/following{/other_user}",
                                                                                                              "gists_url": "https://api.github.com/users/octocat/gists{/gist_id}",
                                                                                                              "starred_url": "https://api.github.com/users/octocat/starred{/owner}{/repo}",
                                                                                                              "subscriptions_url": "https://api.github.com/users/octocat/subscriptions",
                                                                                                              "organizations_url": "https://api.github.com/users/octocat/orgs",
                                                                                                              "repos_url": "https://api.github.com/users/octocat/repos",
                                                                                                              "events_url": "https://api.github.com/users/octocat/events{/privacy}",
                                                                                                              "received_events_url": "https://api.github.com/users/octocat/received_events",
                                                                                                              "type": "User",
                                                                                                              "site_admin": false
                                                                                                            },
                                                                                                            "assignees": [
                                                                                                              {
                                                                                                                "login": "octocat",
                                                                                                                "id": 1,
                                                                                                                "avatar_url": "https://github.com/images/error/octocat_happy.gif",
                                                                                                                "gravatar_id": "",
                                                                                                                "url": "https://api.github.com/users/octocat",
                                                                                                                "html_url": "https://github.com/octocat",
                                                                                                                "followers_url": "https://api.github.com/users/octocat/followers",
                                                                                                                "following_url": "https://api.github.com/users/octocat/following{/other_user}",
                                                                                                                "gists_url": "https://api.github.com/users/octocat/gists{/gist_id}",
                                                                                                                "starred_url": "https://api.github.com/users/octocat/starred{/owner}{/repo}",
                                                                                                                "subscriptions_url": "https://api.github.com/users/octocat/subscriptions",
                                                                                                                "organizations_url": "https://api.github.com/users/octocat/orgs",
                                                                                                                "repos_url": "https://api.github.com/users/octocat/repos",
                                                                                                                "events_url": "https://api.github.com/users/octocat/events{/privacy}",
                                                                                                                "received_events_url": "https://api.github.com/users/octocat/received_events",
                                                                                                                "type": "User",
                                                                                                                "site_admin": false
                                                                                                              },
                                                                                                              {
                                                                                                                "login": "hubot",
                                                                                                                "id": 1,
                                                                                                                "avatar_url": "https://github.com/images/error/hubot_happy.gif",
                                                                                                                "gravatar_id": "",
                                                                                                                "url": "https://api.github.com/users/hubot",
                                                                                                                "html_url": "https://github.com/hubot",
                                                                                                                "followers_url": "https://api.github.com/users/hubot/followers",
                                                                                                                "following_url": "https://api.github.com/users/hubot/following{/other_user}",
                                                                                                                "gists_url": "https://api.github.com/users/hubot/gists{/gist_id}",
                                                                                                                "starred_url": "https://api.github.com/users/hubot/starred{/owner}{/repo}",
                                                                                                                "subscriptions_url": "https://api.github.com/users/hubot/subscriptions",
                                                                                                                "organizations_url": "https://api.github.com/users/hubot/orgs",
                                                                                                                "repos_url": "https://api.github.com/users/hubot/repos",
                                                                                                                "events_url": "https://api.github.com/users/hubot/events{/privacy}",
                                                                                                                "received_events_url": "https://api.github.com/users/hubot/received_events",
                                                                                                                "type": "User",
                                                                                                                "site_admin": true
                                                                                                              },
                                                                                                              {
                                                                                                                "login": "other_user",
                                                                                                                "id": 1,
                                                                                                                "avatar_url": "https://github.com/images/error/other_user_happy.gif",
                                                                                                                "gravatar_id": "",
                                                                                                                "url": "https://api.github.com/users/other_user",
                                                                                                                "html_url": "https://github.com/other_user",
                                                                                                                "followers_url": "https://api.github.com/users/other_user/followers",
                                                                                                                "following_url": "https://api.github.com/users/other_user/following{/other_user}",
                                                                                                                "gists_url": "https://api.github.com/users/other_user/gists{/gist_id}",
                                                                                                                "starred_url": "https://api.github.com/users/other_user/starred{/owner}{/repo}",
                                                                                                                "subscriptions_url": "https://api.github.com/users/other_user/subscriptions",
                                                                                                                "organizations_url": "https://api.github.com/users/other_user/orgs",
                                                                                                                "repos_url": "https://api.github.com/users/other_user/repos",
                                                                                                                "events_url": "https://api.github.com/users/other_user/events{/privacy}",
                                                                                                                "received_events_url": "https://api.github.com/users/other_user/received_events",
                                                                                                                "type": "User",
                                                                                                                "site_admin": false
                                                                                                              }
                                                                                                            ],
                                                                                                            "milestone": {
                                                                                                              "url": "https://api.github.com/repos/octocat/Hello-World/milestones/1",
                                                                                                              "html_url": "https://github.com/octocat/Hello-World/milestones/v1.0",
                                                                                                              "labels_url": "https://api.github.com/repos/octocat/Hello-World/milestones/1/labels",
                                                                                                              "id": 1002604,
                                                                                                              "number": 1,
                                                                                                              "state": "open",
                                                                                                              "title": "v1.0",
                                                                                                              "description": "Tracking milestone for version 1.0",
                                                                                                              "creator": {
                                                                                                                "login": "octocat",
                                                                                                                "id": 1,
                                                                                                                "avatar_url": "https://github.com/images/error/octocat_happy.gif",
                                                                                                                "gravatar_id": "",
                                                                                                                "url": "https://api.github.com/users/octocat",
                                                                                                                "html_url": "https://github.com/octocat",
                                                                                                                "followers_url": "https://api.github.com/users/octocat/followers",
                                                                                                                "following_url": "https://api.github.com/users/octocat/following{/other_user}",
                                                                                                                "gists_url": "https://api.github.com/users/octocat/gists{/gist_id}",
                                                                                                                "starred_url": "https://api.github.com/users/octocat/starred{/owner}{/repo}",
                                                                                                                "subscriptions_url": "https://api.github.com/users/octocat/subscriptions",
                                                                                                                "organizations_url": "https://api.github.com/users/octocat/orgs",
                                                                                                                "repos_url": "https://api.github.com/users/octocat/repos",
                                                                                                                "events_url": "https://api.github.com/users/octocat/events{/privacy}",
                                                                                                                "received_events_url": "https://api.github.com/users/octocat/received_events",
                                                                                                                "type": "User",
                                                                                                                "site_admin": false
                                                                                                              },
                                                                                                              "open_issues": 4,
                                                                                                              "closed_issues": 8,
                                                                                                              "created_at": "2011-04-10T20:09:31Z",
                                                                                                              "updated_at": "2014-03-03T18:58:10Z",
                                                                                                              "closed_at": "2013-02-12T13:22:01Z",
                                                                                                              "due_on": "2012-10-09T23:39:01Z"
                                                                                                            },
                                                                                                            "locked": true,
                                                                                                            "active_lock_reason": "too heated",
                                                                                                            "comments": 0,
                                                                                                            "pull_request": {
                                                                                                              "url": "https://api.github.com/repos/octocat/Hello-World/pulls/1347",
                                                                                                              "html_url": "https://github.com/octocat/Hello-World/pull/1347",
                                                                                                              "diff_url": "https://github.com/octocat/Hello-World/pull/1347.diff",
                                                                                                              "patch_url": "https://github.com/octocat/Hello-World/pull/1347.patch"
                                                                                                            },
                                                                                                            "closed_at": null,
                                                                                                            "created_at": "2011-04-22T13:33:48Z",
                                                                                                            "updated_at": "2011-04-22T13:33:48Z"
                                                                                                          }
                                                                                                          

                                                                                                          Remove assignees from an issue

                                                                                                          Removes one or more assignees from an issue.

                                                                                                          DELETE /repos/:owner/:repo/issues/:number/assignees
                                                                                                          

                                                                                                          Parameters

                                                                                                          Name Type Description
                                                                                                          assignees array of strings Usernames of assignees to remove from an issue. NOTE: Only users with push access can remove assignees from an issue. Assignees are silently ignored otherwise.

                                                                                                          Example

                                                                                                          This example removes two of three assignees, leaving the octocat assignee.

                                                                                                          {
                                                                                                            "assignees": [
                                                                                                              "hubot",
                                                                                                              "other_user"
                                                                                                            ]
                                                                                                          }
                                                                                                          

                                                                                                          Response

                                                                                                          Status: 200 OK
                                                                                                          
                                                                                                          {
                                                                                                            "id": 1,
                                                                                                            "url": "https://api.github.com/repos/octocat/Hello-World/issues/1347",
                                                                                                            "repository_url": "https://api.github.com/repos/octocat/Hello-World",
                                                                                                            "labels_url": "https://api.github.com/repos/octocat/Hello-World/issues/1347/labels{/name}",
                                                                                                            "comments_url": "https://api.github.com/repos/octocat/Hello-World/issues/1347/comments",
                                                                                                            "events_url": "https://api.github.com/repos/octocat/Hello-World/issues/1347/events",
                                                                                                            "html_url": "https://github.com/octocat/Hello-World/issues/1347",
                                                                                                            "number": 1347,
                                                                                                            "state": "open",
                                                                                                            "title": "Found a bug",
                                                                                                            "body": "I'm having a problem with this.",
                                                                                                            "user": {
                                                                                                              "login": "octocat",
                                                                                                              "id": 1,
                                                                                                              "avatar_url": "https://github.com/images/error/octocat_happy.gif",
                                                                                                              "gravatar_id": "",
                                                                                                              "url": "https://api.github.com/users/octocat",
                                                                                                              "html_url": "https://github.com/octocat",
                                                                                                              "followers_url": "https://api.github.com/users/octocat/followers",
                                                                                                              "following_url": "https://api.github.com/users/octocat/following{/other_user}",
                                                                                                              "gists_url": "https://api.github.com/users/octocat/gists{/gist_id}",
                                                                                                              "starred_url": "https://api.github.com/users/octocat/starred{/owner}{/repo}",
                                                                                                              "subscriptions_url": "https://api.github.com/users/octocat/subscriptions",
                                                                                                              "organizations_url": "https://api.github.com/users/octocat/orgs",
                                                                                                              "repos_url": "https://api.github.com/users/octocat/repos",
                                                                                                              "events_url": "https://api.github.com/users/octocat/events{/privacy}",
                                                                                                              "received_events_url": "https://api.github.com/users/octocat/received_events",
                                                                                                              "type": "User",
                                                                                                              "site_admin": false
                                                                                                            },
                                                                                                            "labels": [
                                                                                                              {
                                                                                                                "id": 208045946,
                                                                                                                "url": "https://api.github.com/repos/octocat/Hello-World/labels/bug",
                                                                                                                "name": "bug",
                                                                                                                "color": "f29513",
                                                                                                                "default": true
                                                                                                              }
                                                                                                            ],
                                                                                                            "assignee": {
                                                                                                              "login": "octocat",
                                                                                                              "id": 1,
                                                                                                              "avatar_url": "https://github.com/images/error/octocat_happy.gif",
                                                                                                              "gravatar_id": "",
                                                                                                              "url": "https://api.github.com/users/octocat",
                                                                                                              "html_url": "https://github.com/octocat",
                                                                                                              "followers_url": "https://api.github.com/users/octocat/followers",
                                                                                                              "following_url": "https://api.github.com/users/octocat/following{/other_user}",
                                                                                                              "gists_url": "https://api.github.com/users/octocat/gists{/gist_id}",
                                                                                                              "starred_url": "https://api.github.com/users/octocat/starred{/owner}{/repo}",
                                                                                                              "subscriptions_url": "https://api.github.com/users/octocat/subscriptions",
                                                                                                              "organizations_url": "https://api.github.com/users/octocat/orgs",
                                                                                                              "repos_url": "https://api.github.com/users/octocat/repos",
                                                                                                              "events_url": "https://api.github.com/users/octocat/events{/privacy}",
                                                                                                              "received_events_url": "https://api.github.com/users/octocat/received_events",
                                                                                                              "type": "User",
                                                                                                              "site_admin": false
                                                                                                            },
                                                                                                            "assignees": [
                                                                                                              {
                                                                                                                "login": "octocat",
                                                                                                                "id": 1,
                                                                                                                "avatar_url": "https://github.com/images/error/octocat_happy.gif",
                                                                                                                "gravatar_id": "",
                                                                                                                "url": "https://api.github.com/users/octocat",
                                                                                                                "html_url": "https://github.com/octocat",
                                                                                                                "followers_url": "https://api.github.com/users/octocat/followers",
                                                                                                                "following_url": "https://api.github.com/users/octocat/following{/other_user}",
                                                                                                                "gists_url": "https://api.github.com/users/octocat/gists{/gist_id}",
                                                                                                                "starred_url": "https://api.github.com/users/octocat/starred{/owner}{/repo}",
                                                                                                                "subscriptions_url": "https://api.github.com/users/octocat/subscriptions",
                                                                                                                "organizations_url": "https://api.github.com/users/octocat/orgs",
                                                                                                                "repos_url": "https://api.github.com/users/octocat/repos",
                                                                                                                "events_url": "https://api.github.com/users/octocat/events{/privacy}",
                                                                                                                "received_events_url": "https://api.github.com/users/octocat/received_events",
                                                                                                                "type": "User",
                                                                                                                "site_admin": false
                                                                                                              }
                                                                                                            ],
                                                                                                            "milestone": {
                                                                                                              "url": "https://api.github.com/repos/octocat/Hello-World/milestones/1",
                                                                                                              "html_url": "https://github.com/octocat/Hello-World/milestones/v1.0",
                                                                                                              "labels_url": "https://api.github.com/repos/octocat/Hello-World/milestones/1/labels",
                                                                                                              "id": 1002604,
                                                                                                              "number": 1,
                                                                                                              "state": "open",
                                                                                                              "title": "v1.0",
                                                                                                              "description": "Tracking milestone for version 1.0",
                                                                                                              "creator": {
                                                                                                                "login": "octocat",
                                                                                                                "id": 1,
                                                                                                                "avatar_url": "https://github.com/images/error/octocat_happy.gif",
                                                                                                                "gravatar_id": "",
                                                                                                                "url": "https://api.github.com/users/octocat",
                                                                                                                "html_url": "https://github.com/octocat",
                                                                                                                "followers_url": "https://api.github.com/users/octocat/followers",
                                                                                                                "following_url": "https://api.github.com/users/octocat/following{/other_user}",
                                                                                                                "gists_url": "https://api.github.com/users/octocat/gists{/gist_id}",
                                                                                                                "starred_url": "https://api.github.com/users/octocat/starred{/owner}{/repo}",
                                                                                                                "subscriptions_url": "https://api.github.com/users/octocat/subscriptions",
                                                                                                                "organizations_url": "https://api.github.com/users/octocat/orgs",
                                                                                                                "repos_url": "https://api.github.com/users/octocat/repos",
                                                                                                                "events_url": "https://api.github.com/users/octocat/events{/privacy}",
                                                                                                                "received_events_url": "https://api.github.com/users/octocat/received_events",
                                                                                                                "type": "User",
                                                                                                                "site_admin": false
                                                                                                              },
                                                                                                              "open_issues": 4,
                                                                                                              "closed_issues": 8,
                                                                                                              "created_at": "2011-04-10T20:09:31Z",
                                                                                                              "updated_at": "2014-03-03T18:58:10Z",
                                                                                                              "closed_at": "2013-02-12T13:22:01Z",
                                                                                                              "due_on": "2012-10-09T23:39:01Z"
                                                                                                            },
                                                                                                            "locked": true,
                                                                                                            "active_lock_reason": "too heated",
                                                                                                            "comments": 0,
                                                                                                            "pull_request": {
                                                                                                              "url": "https://api.github.com/repos/octocat/Hello-World/pulls/1347",
                                                                                                              "html_url": "https://github.com/octocat/Hello-World/pull/1347",
                                                                                                              "diff_url": "https://github.com/octocat/Hello-World/pull/1347.diff",
                                                                                                              "patch_url": "https://github.com/octocat/Hello-World/pull/1347.patch"
                                                                                                            },
                                                                                                            "closed_at": null,
                                                                                                            "created_at": "2011-04-22T13:33:48Z",
                                                                                                            "updated_at": "2011-04-22T13:33:48Z"
                                                                                                          }
                                                                                                          
                                                                                                          tmp/developer.github.com/v3/issues/comments/index.html Issue Comments | GitHub Developer Guide

                                                                                                          Comments

                                                                                                          The Issue Comments API supports listing, viewing, editing, and creating comments on issues and pull requests.

                                                                                                          Issue Comments use these custom media types. You can read more about the use of media types in the API here.

                                                                                                          List comments on an issue

                                                                                                          GET /repos/:owner/:repo/issues/:number/comments
                                                                                                          

                                                                                                          Issue Comments are ordered by ascending ID.

                                                                                                          Parameters

                                                                                                          Name Type Description
                                                                                                          since string Only comments updated at or after this time are returned. This is a timestamp in ISO 8601 format: YYYY-MM-DDTHH:MM:SSZ.

                                                                                                          Response

                                                                                                          Status: 200 OK
                                                                                                          Link: <https://api.github.com/resource?page=2>; rel="next",
                                                                                                                <https://api.github.com/resource?page=5>; rel="last"
                                                                                                          
                                                                                                          [
                                                                                                            {
                                                                                                              "id": 1,
                                                                                                              "url": "https://api.github.com/repos/octocat/Hello-World/issues/comments/1",
                                                                                                              "html_url": "https://github.com/octocat/Hello-World/issues/1347#issuecomment-1",
                                                                                                              "body": "Me too",
                                                                                                              "user": {
                                                                                                                "login": "octocat",
                                                                                                                "id": 1,
                                                                                                                "avatar_url": "https://github.com/images/error/octocat_happy.gif",
                                                                                                                "gravatar_id": "",
                                                                                                                "url": "https://api.github.com/users/octocat",
                                                                                                                "html_url": "https://github.com/octocat",
                                                                                                                "followers_url": "https://api.github.com/users/octocat/followers",
                                                                                                                "following_url": "https://api.github.com/users/octocat/following{/other_user}",
                                                                                                                "gists_url": "https://api.github.com/users/octocat/gists{/gist_id}",
                                                                                                                "starred_url": "https://api.github.com/users/octocat/starred{/owner}{/repo}",
                                                                                                                "subscriptions_url": "https://api.github.com/users/octocat/subscriptions",
                                                                                                                "organizations_url": "https://api.github.com/users/octocat/orgs",
                                                                                                                "repos_url": "https://api.github.com/users/octocat/repos",
                                                                                                                "events_url": "https://api.github.com/users/octocat/events{/privacy}",
                                                                                                                "received_events_url": "https://api.github.com/users/octocat/received_events",
                                                                                                                "type": "User",
                                                                                                                "site_admin": false
                                                                                                              },
                                                                                                              "created_at": "2011-04-14T16:00:49Z",
                                                                                                              "updated_at": "2011-04-14T16:00:49Z"
                                                                                                            }
                                                                                                          ]
                                                                                                          

                                                                                                          Reactions summary

                                                                                                          An additional reactions object in the issue comment payload is currently available for developers to preview. During the preview period, the APIs may change without advance notice. Please see the blog post for full details.

                                                                                                          To access the API you must provide a custom media type in the Accept header:

                                                                                                            application/vnd.github.squirrel-girl-preview
                                                                                                          

                                                                                                          The reactions key will have the following payload where url can be used to construct the API location for listing and creating reactions.

                                                                                                          {
                                                                                                            "total_count": 5,
                                                                                                            "+1": 3,
                                                                                                            "-1": 1,
                                                                                                            "laugh": 0,
                                                                                                            "confused": 0,
                                                                                                            "heart": 1,
                                                                                                            "hooray": 0,
                                                                                                            "url": "https://api.github.com/repos/octocat/Hello-World/issues/comments/1/reactions"
                                                                                                          }
                                                                                                          

                                                                                                          List comments in a repository

                                                                                                          GET /repos/:owner/:repo/issues/comments
                                                                                                          

                                                                                                          By default, Issue Comments are ordered by ascending ID.

                                                                                                          Parameters

                                                                                                          Name Type Description
                                                                                                          sort string Either created or updated. Default: created
                                                                                                          direction string Either asc or desc. Ignored without the sort parameter.
                                                                                                          since string Only comments updated at or after this time are returned. This is a timestamp in ISO 8601 format: YYYY-MM-DDTHH:MM:SSZ.

                                                                                                          Response

                                                                                                          Status: 200 OK
                                                                                                          
                                                                                                          [
                                                                                                            {
                                                                                                              "id": 1,
                                                                                                              "url": "https://api.github.com/repos/octocat/Hello-World/issues/comments/1",
                                                                                                              "html_url": "https://github.com/octocat/Hello-World/issues/1347#issuecomment-1",
                                                                                                              "body": "Me too",
                                                                                                              "user": {
                                                                                                                "login": "octocat",
                                                                                                                "id": 1,
                                                                                                                "avatar_url": "https://github.com/images/error/octocat_happy.gif",
                                                                                                                "gravatar_id": "",
                                                                                                                "url": "https://api.github.com/users/octocat",
                                                                                                                "html_url": "https://github.com/octocat",
                                                                                                                "followers_url": "https://api.github.com/users/octocat/followers",
                                                                                                                "following_url": "https://api.github.com/users/octocat/following{/other_user}",
                                                                                                                "gists_url": "https://api.github.com/users/octocat/gists{/gist_id}",
                                                                                                                "starred_url": "https://api.github.com/users/octocat/starred{/owner}{/repo}",
                                                                                                                "subscriptions_url": "https://api.github.com/users/octocat/subscriptions",
                                                                                                                "organizations_url": "https://api.github.com/users/octocat/orgs",
                                                                                                                "repos_url": "https://api.github.com/users/octocat/repos",
                                                                                                                "events_url": "https://api.github.com/users/octocat/events{/privacy}",
                                                                                                                "received_events_url": "https://api.github.com/users/octocat/received_events",
                                                                                                                "type": "User",
                                                                                                                "site_admin": false
                                                                                                              },
                                                                                                              "created_at": "2011-04-14T16:00:49Z",
                                                                                                              "updated_at": "2011-04-14T16:00:49Z"
                                                                                                            }
                                                                                                          ]
                                                                                                          

                                                                                                          Reactions summary

                                                                                                          An additional reactions object in the issue comment payload is currently available for developers to preview. During the preview period, the APIs may change without advance notice. Please see the blog post for full details.

                                                                                                          To access the API you must provide a custom media type in the Accept header:

                                                                                                            application/vnd.github.squirrel-girl-preview
                                                                                                          

                                                                                                          The reactions key will have the following payload where url can be used to construct the API location for listing and creating reactions.

                                                                                                          {
                                                                                                            "total_count": 5,
                                                                                                            "+1": 3,
                                                                                                            "-1": 1,
                                                                                                            "laugh": 0,
                                                                                                            "confused": 0,
                                                                                                            "heart": 1,
                                                                                                            "hooray": 0,
                                                                                                            "url": "https://api.github.com/repos/octocat/Hello-World/issues/comments/1/reactions"
                                                                                                          }
                                                                                                          

                                                                                                          Get a single comment

                                                                                                          GET /repos/:owner/:repo/issues/comments/:id
                                                                                                          

                                                                                                          Response

                                                                                                          Status: 200 OK
                                                                                                          Link: <https://api.github.com/resource?page=2>; rel="next",
                                                                                                                <https://api.github.com/resource?page=5>; rel="last"
                                                                                                          
                                                                                                          {
                                                                                                            "id": 1,
                                                                                                            "url": "https://api.github.com/repos/octocat/Hello-World/issues/comments/1",
                                                                                                            "html_url": "https://github.com/octocat/Hello-World/issues/1347#issuecomment-1",
                                                                                                            "body": "Me too",
                                                                                                            "user": {
                                                                                                              "login": "octocat",
                                                                                                              "id": 1,
                                                                                                              "avatar_url": "https://github.com/images/error/octocat_happy.gif",
                                                                                                              "gravatar_id": "",
                                                                                                              "url": "https://api.github.com/users/octocat",
                                                                                                              "html_url": "https://github.com/octocat",
                                                                                                              "followers_url": "https://api.github.com/users/octocat/followers",
                                                                                                              "following_url": "https://api.github.com/users/octocat/following{/other_user}",
                                                                                                              "gists_url": "https://api.github.com/users/octocat/gists{/gist_id}",
                                                                                                              "starred_url": "https://api.github.com/users/octocat/starred{/owner}{/repo}",
                                                                                                              "subscriptions_url": "https://api.github.com/users/octocat/subscriptions",
                                                                                                              "organizations_url": "https://api.github.com/users/octocat/orgs",
                                                                                                              "repos_url": "https://api.github.com/users/octocat/repos",
                                                                                                              "events_url": "https://api.github.com/users/octocat/events{/privacy}",
                                                                                                              "received_events_url": "https://api.github.com/users/octocat/received_events",
                                                                                                              "type": "User",
                                                                                                              "site_admin": false
                                                                                                            },
                                                                                                            "created_at": "2011-04-14T16:00:49Z",
                                                                                                            "updated_at": "2011-04-14T16:00:49Z"
                                                                                                          }
                                                                                                          

                                                                                                          Reactions summary

                                                                                                          An additional reactions object in the issue comment payload is currently available for developers to preview. During the preview period, the APIs may change without advance notice. Please see the blog post for full details.

                                                                                                          To access the API you must provide a custom media type in the Accept header:

                                                                                                            application/vnd.github.squirrel-girl-preview
                                                                                                          

                                                                                                          The reactions key will have the following payload where url can be used to construct the API location for listing and creating reactions.

                                                                                                          {
                                                                                                            "total_count": 5,
                                                                                                            "+1": 3,
                                                                                                            "-1": 1,
                                                                                                            "laugh": 0,
                                                                                                            "confused": 0,
                                                                                                            "heart": 1,
                                                                                                            "hooray": 0,
                                                                                                            "url": "https://api.github.com/repos/octocat/Hello-World/issues/comments/1/reactions"
                                                                                                          }
                                                                                                          

                                                                                                          Issue comments created by users via integrations

                                                                                                          Note: An additional performed_via_github_app object in the issue payload is currently available for developers to preview. For more information, see the related blog post.

                                                                                                          To access the API, you must provide a custom media type in the Accept header:

                                                                                                          application/vnd.github.machine-man-preview
                                                                                                          

                                                                                                          Note: If a user created an issue comment via a GitHub App, the performed_via_github_app key will contain information on that GitHub App.

                                                                                                          Warning: The API may change without advance notice during the preview period. Preview features are not supported for production use. If you experience any issues, contact GitHub support.

                                                                                                          Create a comment

                                                                                                          POST /repos/:owner/:repo/issues/:number/comments
                                                                                                          

                                                                                                          Input

                                                                                                          Name Type Description
                                                                                                          body string Required. The contents of the comment.
                                                                                                          {
                                                                                                            "body": "Me too"
                                                                                                          }
                                                                                                          

                                                                                                          Response

                                                                                                          Status: 201 Created
                                                                                                          Location: https://api.github.com/repos/octocat/Hello-World/issues/comments/1
                                                                                                          
                                                                                                          {
                                                                                                            "id": 1,
                                                                                                            "url": "https://api.github.com/repos/octocat/Hello-World/issues/comments/1",
                                                                                                            "html_url": "https://github.com/octocat/Hello-World/issues/1347#issuecomment-1",
                                                                                                            "body": "Me too",
                                                                                                            "user": {
                                                                                                              "login": "octocat",
                                                                                                              "id": 1,
                                                                                                              "avatar_url": "https://github.com/images/error/octocat_happy.gif",
                                                                                                              "gravatar_id": "",
                                                                                                              "url": "https://api.github.com/users/octocat",
                                                                                                              "html_url": "https://github.com/octocat",
                                                                                                              "followers_url": "https://api.github.com/users/octocat/followers",
                                                                                                              "following_url": "https://api.github.com/users/octocat/following{/other_user}",
                                                                                                              "gists_url": "https://api.github.com/users/octocat/gists{/gist_id}",
                                                                                                              "starred_url": "https://api.github.com/users/octocat/starred{/owner}{/repo}",
                                                                                                              "subscriptions_url": "https://api.github.com/users/octocat/subscriptions",
                                                                                                              "organizations_url": "https://api.github.com/users/octocat/orgs",
                                                                                                              "repos_url": "https://api.github.com/users/octocat/repos",
                                                                                                              "events_url": "https://api.github.com/users/octocat/events{/privacy}",
                                                                                                              "received_events_url": "https://api.github.com/users/octocat/received_events",
                                                                                                              "type": "User",
                                                                                                              "site_admin": false
                                                                                                            },
                                                                                                            "created_at": "2011-04-14T16:00:49Z",
                                                                                                            "updated_at": "2011-04-14T16:00:49Z"
                                                                                                          }
                                                                                                          

                                                                                                          Edit a comment

                                                                                                          PATCH /repos/:owner/:repo/issues/comments/:id
                                                                                                          

                                                                                                          Input

                                                                                                          Name Type Description
                                                                                                          body string Required. The contents of the comment.
                                                                                                          {
                                                                                                            "body": "Me too"
                                                                                                          }
                                                                                                          

                                                                                                          Response

                                                                                                          Status: 200 OK
                                                                                                          
                                                                                                          {
                                                                                                            "id": 1,
                                                                                                            "url": "https://api.github.com/repos/octocat/Hello-World/issues/comments/1",
                                                                                                            "html_url": "https://github.com/octocat/Hello-World/issues/1347#issuecomment-1",
                                                                                                            "body": "Me too",
                                                                                                            "user": {
                                                                                                              "login": "octocat",
                                                                                                              "id": 1,
                                                                                                              "avatar_url": "https://github.com/images/error/octocat_happy.gif",
                                                                                                              "gravatar_id": "",
                                                                                                              "url": "https://api.github.com/users/octocat",
                                                                                                              "html_url": "https://github.com/octocat",
                                                                                                              "followers_url": "https://api.github.com/users/octocat/followers",
                                                                                                              "following_url": "https://api.github.com/users/octocat/following{/other_user}",
                                                                                                              "gists_url": "https://api.github.com/users/octocat/gists{/gist_id}",
                                                                                                              "starred_url": "https://api.github.com/users/octocat/starred{/owner}{/repo}",
                                                                                                              "subscriptions_url": "https://api.github.com/users/octocat/subscriptions",
                                                                                                              "organizations_url": "https://api.github.com/users/octocat/orgs",
                                                                                                              "repos_url": "https://api.github.com/users/octocat/repos",
                                                                                                              "events_url": "https://api.github.com/users/octocat/events{/privacy}",
                                                                                                              "received_events_url": "https://api.github.com/users/octocat/received_events",
                                                                                                              "type": "User",
                                                                                                              "site_admin": false
                                                                                                            },
                                                                                                            "created_at": "2011-04-14T16:00:49Z",
                                                                                                            "updated_at": "2011-04-14T16:00:49Z"
                                                                                                          }
                                                                                                          

                                                                                                          Delete a comment

                                                                                                          DELETE /repos/:owner/:repo/issues/comments/:id
                                                                                                          

                                                                                                          Response

                                                                                                          Status: 204 No Content
                                                                                                          

                                                                                                          Custom media types

                                                                                                          These are the supported media types for issue comments. You can read more about the use of media types in the API here.

                                                                                                          application/vnd.github.VERSION.raw+json
                                                                                                          application/vnd.github.VERSION.text+json
                                                                                                          application/vnd.github.VERSION.html+json
                                                                                                          application/vnd.github.VERSION.full+json
                                                                                                          
                                                                                                          tmp/developer.github.com/v3/issues/events/index.html Issue Events | GitHub Developer Guide

                                                                                                          Events

                                                                                                          Records various events that occur around an issue or pull request. This is useful both for display on issue/pull request information pages and also to determine who should be notified of comments.

                                                                                                          Attributes

                                                                                                          id
                                                                                                          The Integer ID of the event.
                                                                                                          url
                                                                                                          The API URL for fetching the event.
                                                                                                          actor
                                                                                                          The User object that generated the event.
                                                                                                          commit_id
                                                                                                          The String SHA of a commit that referenced this Issue
                                                                                                          commit_url
                                                                                                          The GitHub API link to a commit that referenced this Issue
                                                                                                          event
                                                                                                          Identifies the actual type of Event that occurred.
                                                                                                          created_at
                                                                                                          The timestamp indicating when the event occurred.
                                                                                                          labels
                                                                                                          The Labels object, including `name` and `color` attributes. Only provided for `labeled` and `unlabeled` events.
                                                                                                          assignee
                                                                                                          The User object which was assigned to (or unassigned from) this Issue. Only provided for 'assigned' and 'unassigned' events.
                                                                                                          assigner
                                                                                                          The User object that performed the assignment (or unassignment) for this Issue. Only provided for 'assigned' and 'unassigned' events.
                                                                                                          review_requester
                                                                                                          The User who requested a review. Only provided for 'review_requested' and 'review_request_removed' events.
                                                                                                          requested_reviewers
                                                                                                          The Users whose reviews were requested. Only provided for 'review_requested' and 'review_request_removed' events.
                                                                                                          lock_reason
                                                                                                          The reason an issue or pull request conversation was locked, if one was provided. Only provided for `locked` events.
                                                                                                          dismissed_review
                                                                                                          A `dismissed_review` object that includes the `state`, `review_id`, `dismissal_message`, and `dismissal_commit_id` (the ID of the commit that dismissed the review) if one exists. Possible `state` strings include `commented`, `approved`, or `changes_requested`. Only provided for `review_dismissed` events.
                                                                                                          milestone
                                                                                                          The Milestone object including a `title` attribute. Only provided for `milestoned` and `demilestoned` events.
                                                                                                          rename
                                                                                                          An object containing rename details including `from` and `to` attributes. Only provided for `renamed` events.

                                                                                                          Events

                                                                                                          closed
                                                                                                          The issue was closed by the actor. When the commit_id is present, it identifies the commit that closed the issue using "closes / fixes #NN" syntax.
                                                                                                          reopened
                                                                                                          The issue was reopened by the actor.
                                                                                                          subscribed
                                                                                                          The actor subscribed to receive notifications for an issue.
                                                                                                          merged
                                                                                                          The issue was merged by the actor. The `commit_id` attribute is the SHA1 of the HEAD commit that was merged.
                                                                                                          referenced
                                                                                                          The issue was referenced from a commit message. The `commit_id` attribute is the commit SHA1 of where that happened.
                                                                                                          mentioned
                                                                                                          The actor was @mentioned in an issue body.
                                                                                                          assigned
                                                                                                          The issue was assigned to the actor.
                                                                                                          unassigned
                                                                                                          The actor was unassigned from the issue.
                                                                                                          labeled
                                                                                                          A label was added to the issue.
                                                                                                          unlabeled
                                                                                                          A label was removed from the issue.
                                                                                                          milestoned
                                                                                                          The issue was added to a milestone.
                                                                                                          demilestoned
                                                                                                          The issue was removed from a milestone.
                                                                                                          renamed
                                                                                                          The issue title was changed.
                                                                                                          locked
                                                                                                          The issue was locked by the actor.
                                                                                                          unlocked
                                                                                                          The issue was unlocked by the actor.
                                                                                                          head_ref_deleted
                                                                                                          The pull request's branch was deleted.
                                                                                                          head_ref_restored
                                                                                                          The pull request's branch was restored.
                                                                                                          review_dismissed
                                                                                                          The actor dismissed a review from the pull request.
                                                                                                          review_requested
                                                                                                          The actor requested review from the subject on this pull request.
                                                                                                          review_request_removed
                                                                                                          The actor removed the review request for the subject on this pull request.
                                                                                                          marked_as_duplicate
                                                                                                          A user with write permissions marked an issue as a duplicate of another issue or a pull request as a duplicate of another pull request.
                                                                                                          unmarked_as_duplicate
                                                                                                          An issue that a user had previously marked as a duplicate of another issue is no longer considered a duplicate, or a pull request that a user had previously marked as a duplicate of another pull request is no longer considered a duplicate.
                                                                                                          added_to_project
                                                                                                          The issue was added to a project board.
                                                                                                          moved_columns_in_project
                                                                                                          The issue was moved between columns in a project board.
                                                                                                          removed_from_project
                                                                                                          The issue was removed from a project board.
                                                                                                          converted_note_to_issue
                                                                                                          The issue was created by converting a note in a project board to an issue.

                                                                                                          Note: The project-related events added_to_project, moved_columns_in_project, removed_from_project, and converted_note_to_issue will not be included in the response if project boards have been disabled in the repository.

                                                                                                          List events for an issue

                                                                                                          GET /repos/:owner/:repo/issues/:number/events
                                                                                                          

                                                                                                          Response

                                                                                                          Status: 200 OK
                                                                                                          Link: <https://api.github.com/resource?page=2>; rel="next",
                                                                                                                <https://api.github.com/resource?page=5>; rel="last"
                                                                                                          
                                                                                                          [
                                                                                                            {
                                                                                                              "id": 1,
                                                                                                              "url": "https://api.github.com/repos/octocat/Hello-World/issues/events/1",
                                                                                                              "actor": {
                                                                                                                "login": "octocat",
                                                                                                                "id": 1,
                                                                                                                "avatar_url": "https://github.com/images/error/octocat_happy.gif",
                                                                                                                "gravatar_id": "",
                                                                                                                "url": "https://api.github.com/users/octocat",
                                                                                                                "html_url": "https://github.com/octocat",
                                                                                                                "followers_url": "https://api.github.com/users/octocat/followers",
                                                                                                                "following_url": "https://api.github.com/users/octocat/following{/other_user}",
                                                                                                                "gists_url": "https://api.github.com/users/octocat/gists{/gist_id}",
                                                                                                                "starred_url": "https://api.github.com/users/octocat/starred{/owner}{/repo}",
                                                                                                                "subscriptions_url": "https://api.github.com/users/octocat/subscriptions",
                                                                                                                "organizations_url": "https://api.github.com/users/octocat/orgs",
                                                                                                                "repos_url": "https://api.github.com/users/octocat/repos",
                                                                                                                "events_url": "https://api.github.com/users/octocat/events{/privacy}",
                                                                                                                "received_events_url": "https://api.github.com/users/octocat/received_events",
                                                                                                                "type": "User",
                                                                                                                "site_admin": false
                                                                                                              },
                                                                                                              "event": "closed",
                                                                                                              "commit_id": "6dcb09b5b57875f334f61aebed695e2e4193db5e",
                                                                                                              "commit_url": "https://api.github.com/repos/octocat/Hello-World/commits/6dcb09b5b57875f334f61aebed695e2e4193db5e",
                                                                                                              "created_at": "2011-04-14T16:00:49Z"
                                                                                                            }
                                                                                                          ]
                                                                                                          

                                                                                                          List events for a repository

                                                                                                          GET /repos/:owner/:repo/issues/events
                                                                                                          

                                                                                                          Response

                                                                                                          Status: 200 OK
                                                                                                          Link: <https://api.github.com/resource?page=2>; rel="next",
                                                                                                                <https://api.github.com/resource?page=5>; rel="last"
                                                                                                          
                                                                                                          [
                                                                                                            {
                                                                                                              "id": 1,
                                                                                                              "url": "https://api.github.com/repos/octocat/Hello-World/issues/events/1",
                                                                                                              "actor": {
                                                                                                                "login": "octocat",
                                                                                                                "id": 1,
                                                                                                                "avatar_url": "https://github.com/images/error/octocat_happy.gif",
                                                                                                                "gravatar_id": "",
                                                                                                                "url": "https://api.github.com/users/octocat",
                                                                                                                "html_url": "https://github.com/octocat",
                                                                                                                "followers_url": "https://api.github.com/users/octocat/followers",
                                                                                                                "following_url": "https://api.github.com/users/octocat/following{/other_user}",
                                                                                                                "gists_url": "https://api.github.com/users/octocat/gists{/gist_id}",
                                                                                                                "starred_url": "https://api.github.com/users/octocat/starred{/owner}{/repo}",
                                                                                                                "subscriptions_url": "https://api.github.com/users/octocat/subscriptions",
                                                                                                                "organizations_url": "https://api.github.com/users/octocat/orgs",
                                                                                                                "repos_url": "https://api.github.com/users/octocat/repos",
                                                                                                                "events_url": "https://api.github.com/users/octocat/events{/privacy}",
                                                                                                                "received_events_url": "https://api.github.com/users/octocat/received_events",
                                                                                                                "type": "User",
                                                                                                                "site_admin": false
                                                                                                              },
                                                                                                              "event": "closed",
                                                                                                              "commit_id": "6dcb09b5b57875f334f61aebed695e2e4193db5e",
                                                                                                              "commit_url": "https://api.github.com/repos/octocat/Hello-World/commits/6dcb09b5b57875f334f61aebed695e2e4193db5e",
                                                                                                              "created_at": "2011-04-14T16:00:49Z",
                                                                                                              "issue": {
                                                                                                                "id": 1,
                                                                                                                "url": "https://api.github.com/repos/octocat/Hello-World/issues/1347",
                                                                                                                "repository_url": "https://api.github.com/repos/octocat/Hello-World",
                                                                                                                "labels_url": "https://api.github.com/repos/octocat/Hello-World/issues/1347/labels{/name}",
                                                                                                                "comments_url": "https://api.github.com/repos/octocat/Hello-World/issues/1347/comments",
                                                                                                                "events_url": "https://api.github.com/repos/octocat/Hello-World/issues/1347/events",
                                                                                                                "html_url": "https://github.com/octocat/Hello-World/issues/1347",
                                                                                                                "number": 1347,
                                                                                                                "state": "open",
                                                                                                                "title": "Found a bug",
                                                                                                                "body": "I'm having a problem with this.",
                                                                                                                "user": {
                                                                                                                  "login": "octocat",
                                                                                                                  "id": 1,
                                                                                                                  "avatar_url": "https://github.com/images/error/octocat_happy.gif",
                                                                                                                  "gravatar_id": "",
                                                                                                                  "url": "https://api.github.com/users/octocat",
                                                                                                                  "html_url": "https://github.com/octocat",
                                                                                                                  "followers_url": "https://api.github.com/users/octocat/followers",
                                                                                                                  "following_url": "https://api.github.com/users/octocat/following{/other_user}",
                                                                                                                  "gists_url": "https://api.github.com/users/octocat/gists{/gist_id}",
                                                                                                                  "starred_url": "https://api.github.com/users/octocat/starred{/owner}{/repo}",
                                                                                                                  "subscriptions_url": "https://api.github.com/users/octocat/subscriptions",
                                                                                                                  "organizations_url": "https://api.github.com/users/octocat/orgs",
                                                                                                                  "repos_url": "https://api.github.com/users/octocat/repos",
                                                                                                                  "events_url": "https://api.github.com/users/octocat/events{/privacy}",
                                                                                                                  "received_events_url": "https://api.github.com/users/octocat/received_events",
                                                                                                                  "type": "User",
                                                                                                                  "site_admin": false
                                                                                                                },
                                                                                                                "labels": [
                                                                                                                  {
                                                                                                                    "id": 208045946,
                                                                                                                    "url": "https://api.github.com/repos/octocat/Hello-World/labels/bug",
                                                                                                                    "name": "bug",
                                                                                                                    "color": "f29513",
                                                                                                                    "default": true
                                                                                                                  }
                                                                                                                ],
                                                                                                                "assignee": {
                                                                                                                  "login": "octocat",
                                                                                                                  "id": 1,
                                                                                                                  "avatar_url": "https://github.com/images/error/octocat_happy.gif",
                                                                                                                  "gravatar_id": "",
                                                                                                                  "url": "https://api.github.com/users/octocat",
                                                                                                                  "html_url": "https://github.com/octocat",
                                                                                                                  "followers_url": "https://api.github.com/users/octocat/followers",
                                                                                                                  "following_url": "https://api.github.com/users/octocat/following{/other_user}",
                                                                                                                  "gists_url": "https://api.github.com/users/octocat/gists{/gist_id}",
                                                                                                                  "starred_url": "https://api.github.com/users/octocat/starred{/owner}{/repo}",
                                                                                                                  "subscriptions_url": "https://api.github.com/users/octocat/subscriptions",
                                                                                                                  "organizations_url": "https://api.github.com/users/octocat/orgs",
                                                                                                                  "repos_url": "https://api.github.com/users/octocat/repos",
                                                                                                                  "events_url": "https://api.github.com/users/octocat/events{/privacy}",
                                                                                                                  "received_events_url": "https://api.github.com/users/octocat/received_events",
                                                                                                                  "type": "User",
                                                                                                                  "site_admin": false
                                                                                                                },
                                                                                                                "assignees": [
                                                                                                                  {
                                                                                                                    "login": "octocat",
                                                                                                                    "id": 1,
                                                                                                                    "avatar_url": "https://github.com/images/error/octocat_happy.gif",
                                                                                                                    "gravatar_id": "",
                                                                                                                    "url": "https://api.github.com/users/octocat",
                                                                                                                    "html_url": "https://github.com/octocat",
                                                                                                                    "followers_url": "https://api.github.com/users/octocat/followers",
                                                                                                                    "following_url": "https://api.github.com/users/octocat/following{/other_user}",
                                                                                                                    "gists_url": "https://api.github.com/users/octocat/gists{/gist_id}",
                                                                                                                    "starred_url": "https://api.github.com/users/octocat/starred{/owner}{/repo}",
                                                                                                                    "subscriptions_url": "https://api.github.com/users/octocat/subscriptions",
                                                                                                                    "organizations_url": "https://api.github.com/users/octocat/orgs",
                                                                                                                    "repos_url": "https://api.github.com/users/octocat/repos",
                                                                                                                    "events_url": "https://api.github.com/users/octocat/events{/privacy}",
                                                                                                                    "received_events_url": "https://api.github.com/users/octocat/received_events",
                                                                                                                    "type": "User",
                                                                                                                    "site_admin": false
                                                                                                                  }
                                                                                                                ],
                                                                                                                "milestone": {
                                                                                                                  "url": "https://api.github.com/repos/octocat/Hello-World/milestones/1",
                                                                                                                  "html_url": "https://github.com/octocat/Hello-World/milestones/v1.0",
                                                                                                                  "labels_url": "https://api.github.com/repos/octocat/Hello-World/milestones/1/labels",
                                                                                                                  "id": 1002604,
                                                                                                                  "number": 1,
                                                                                                                  "state": "open",
                                                                                                                  "title": "v1.0",
                                                                                                                  "description": "Tracking milestone for version 1.0",
                                                                                                                  "creator": {
                                                                                                                    "login": "octocat",
                                                                                                                    "id": 1,
                                                                                                                    "avatar_url": "https://github.com/images/error/octocat_happy.gif",
                                                                                                                    "gravatar_id": "",
                                                                                                                    "url": "https://api.github.com/users/octocat",
                                                                                                                    "html_url": "https://github.com/octocat",
                                                                                                                    "followers_url": "https://api.github.com/users/octocat/followers",
                                                                                                                    "following_url": "https://api.github.com/users/octocat/following{/other_user}",
                                                                                                                    "gists_url": "https://api.github.com/users/octocat/gists{/gist_id}",
                                                                                                                    "starred_url": "https://api.github.com/users/octocat/starred{/owner}{/repo}",
                                                                                                                    "subscriptions_url": "https://api.github.com/users/octocat/subscriptions",
                                                                                                                    "organizations_url": "https://api.github.com/users/octocat/orgs",
                                                                                                                    "repos_url": "https://api.github.com/users/octocat/repos",
                                                                                                                    "events_url": "https://api.github.com/users/octocat/events{/privacy}",
                                                                                                                    "received_events_url": "https://api.github.com/users/octocat/received_events",
                                                                                                                    "type": "User",
                                                                                                                    "site_admin": false
                                                                                                                  },
                                                                                                                  "open_issues": 4,
                                                                                                                  "closed_issues": 8,
                                                                                                                  "created_at": "2011-04-10T20:09:31Z",
                                                                                                                  "updated_at": "2014-03-03T18:58:10Z",
                                                                                                                  "closed_at": "2013-02-12T13:22:01Z",
                                                                                                                  "due_on": "2012-10-09T23:39:01Z"
                                                                                                                },
                                                                                                                "locked": true,
                                                                                                                "active_lock_reason": "too heated",
                                                                                                                "comments": 0,
                                                                                                                "pull_request": {
                                                                                                                  "url": "https://api.github.com/repos/octocat/Hello-World/pulls/1347",
                                                                                                                  "html_url": "https://github.com/octocat/Hello-World/pull/1347",
                                                                                                                  "diff_url": "https://github.com/octocat/Hello-World/pull/1347.diff",
                                                                                                                  "patch_url": "https://github.com/octocat/Hello-World/pull/1347.patch"
                                                                                                                },
                                                                                                                "closed_at": null,
                                                                                                                "created_at": "2011-04-22T13:33:48Z",
                                                                                                                "updated_at": "2011-04-22T13:33:48Z"
                                                                                                              }
                                                                                                            }
                                                                                                          ]
                                                                                                          

                                                                                                          Get a single event

                                                                                                          GET /repos/:owner/:repo/issues/events/:id
                                                                                                          

                                                                                                          Response

                                                                                                          Status: 200 OK
                                                                                                          
                                                                                                          {
                                                                                                            "id": 1,
                                                                                                            "url": "https://api.github.com/repos/octocat/Hello-World/issues/events/1",
                                                                                                            "actor": {
                                                                                                              "login": "octocat",
                                                                                                              "id": 1,
                                                                                                              "avatar_url": "https://github.com/images/error/octocat_happy.gif",
                                                                                                              "gravatar_id": "",
                                                                                                              "url": "https://api.github.com/users/octocat",
                                                                                                              "html_url": "https://github.com/octocat",
                                                                                                              "followers_url": "https://api.github.com/users/octocat/followers",
                                                                                                              "following_url": "https://api.github.com/users/octocat/following{/other_user}",
                                                                                                              "gists_url": "https://api.github.com/users/octocat/gists{/gist_id}",
                                                                                                              "starred_url": "https://api.github.com/users/octocat/starred{/owner}{/repo}",
                                                                                                              "subscriptions_url": "https://api.github.com/users/octocat/subscriptions",
                                                                                                              "organizations_url": "https://api.github.com/users/octocat/orgs",
                                                                                                              "repos_url": "https://api.github.com/users/octocat/repos",
                                                                                                              "events_url": "https://api.github.com/users/octocat/events{/privacy}",
                                                                                                              "received_events_url": "https://api.github.com/users/octocat/received_events",
                                                                                                              "type": "User",
                                                                                                              "site_admin": false
                                                                                                            },
                                                                                                            "event": "closed",
                                                                                                            "commit_id": "6dcb09b5b57875f334f61aebed695e2e4193db5e",
                                                                                                            "commit_url": "https://api.github.com/repos/octocat/Hello-World/commits/6dcb09b5b57875f334f61aebed695e2e4193db5e",
                                                                                                            "created_at": "2011-04-14T16:00:49Z",
                                                                                                            "issue": {
                                                                                                              "id": 1,
                                                                                                              "url": "https://api.github.com/repos/octocat/Hello-World/issues/1347",
                                                                                                              "repository_url": "https://api.github.com/repos/octocat/Hello-World",
                                                                                                              "labels_url": "https://api.github.com/repos/octocat/Hello-World/issues/1347/labels{/name}",
                                                                                                              "comments_url": "https://api.github.com/repos/octocat/Hello-World/issues/1347/comments",
                                                                                                              "events_url": "https://api.github.com/repos/octocat/Hello-World/issues/1347/events",
                                                                                                              "html_url": "https://github.com/octocat/Hello-World/issues/1347",
                                                                                                              "number": 1347,
                                                                                                              "state": "open",
                                                                                                              "title": "Found a bug",
                                                                                                              "body": "I'm having a problem with this.",
                                                                                                              "user": {
                                                                                                                "login": "octocat",
                                                                                                                "id": 1,
                                                                                                                "avatar_url": "https://github.com/images/error/octocat_happy.gif",
                                                                                                                "gravatar_id": "",
                                                                                                                "url": "https://api.github.com/users/octocat",
                                                                                                                "html_url": "https://github.com/octocat",
                                                                                                                "followers_url": "https://api.github.com/users/octocat/followers",
                                                                                                                "following_url": "https://api.github.com/users/octocat/following{/other_user}",
                                                                                                                "gists_url": "https://api.github.com/users/octocat/gists{/gist_id}",
                                                                                                                "starred_url": "https://api.github.com/users/octocat/starred{/owner}{/repo}",
                                                                                                                "subscriptions_url": "https://api.github.com/users/octocat/subscriptions",
                                                                                                                "organizations_url": "https://api.github.com/users/octocat/orgs",
                                                                                                                "repos_url": "https://api.github.com/users/octocat/repos",
                                                                                                                "events_url": "https://api.github.com/users/octocat/events{/privacy}",
                                                                                                                "received_events_url": "https://api.github.com/users/octocat/received_events",
                                                                                                                "type": "User",
                                                                                                                "site_admin": false
                                                                                                              },
                                                                                                              "labels": [
                                                                                                                {
                                                                                                                  "id": 208045946,
                                                                                                                  "url": "https://api.github.com/repos/octocat/Hello-World/labels/bug",
                                                                                                                  "name": "bug",
                                                                                                                  "color": "f29513",
                                                                                                                  "default": true
                                                                                                                }
                                                                                                              ],
                                                                                                              "assignee": {
                                                                                                                "login": "octocat",
                                                                                                                "id": 1,
                                                                                                                "avatar_url": "https://github.com/images/error/octocat_happy.gif",
                                                                                                                "gravatar_id": "",
                                                                                                                "url": "https://api.github.com/users/octocat",
                                                                                                                "html_url": "https://github.com/octocat",
                                                                                                                "followers_url": "https://api.github.com/users/octocat/followers",
                                                                                                                "following_url": "https://api.github.com/users/octocat/following{/other_user}",
                                                                                                                "gists_url": "https://api.github.com/users/octocat/gists{/gist_id}",
                                                                                                                "starred_url": "https://api.github.com/users/octocat/starred{/owner}{/repo}",
                                                                                                                "subscriptions_url": "https://api.github.com/users/octocat/subscriptions",
                                                                                                                "organizations_url": "https://api.github.com/users/octocat/orgs",
                                                                                                                "repos_url": "https://api.github.com/users/octocat/repos",
                                                                                                                "events_url": "https://api.github.com/users/octocat/events{/privacy}",
                                                                                                                "received_events_url": "https://api.github.com/users/octocat/received_events",
                                                                                                                "type": "User",
                                                                                                                "site_admin": false
                                                                                                              },
                                                                                                              "assignees": [
                                                                                                                {
                                                                                                                  "login": "octocat",
                                                                                                                  "id": 1,
                                                                                                                  "avatar_url": "https://github.com/images/error/octocat_happy.gif",
                                                                                                                  "gravatar_id": "",
                                                                                                                  "url": "https://api.github.com/users/octocat",
                                                                                                                  "html_url": "https://github.com/octocat",
                                                                                                                  "followers_url": "https://api.github.com/users/octocat/followers",
                                                                                                                  "following_url": "https://api.github.com/users/octocat/following{/other_user}",
                                                                                                                  "gists_url": "https://api.github.com/users/octocat/gists{/gist_id}",
                                                                                                                  "starred_url": "https://api.github.com/users/octocat/starred{/owner}{/repo}",
                                                                                                                  "subscriptions_url": "https://api.github.com/users/octocat/subscriptions",
                                                                                                                  "organizations_url": "https://api.github.com/users/octocat/orgs",
                                                                                                                  "repos_url": "https://api.github.com/users/octocat/repos",
                                                                                                                  "events_url": "https://api.github.com/users/octocat/events{/privacy}",
                                                                                                                  "received_events_url": "https://api.github.com/users/octocat/received_events",
                                                                                                                  "type": "User",
                                                                                                                  "site_admin": false
                                                                                                                }
                                                                                                              ],
                                                                                                              "milestone": {
                                                                                                                "url": "https://api.github.com/repos/octocat/Hello-World/milestones/1",
                                                                                                                "html_url": "https://github.com/octocat/Hello-World/milestones/v1.0",
                                                                                                                "labels_url": "https://api.github.com/repos/octocat/Hello-World/milestones/1/labels",
                                                                                                                "id": 1002604,
                                                                                                                "number": 1,
                                                                                                                "state": "open",
                                                                                                                "title": "v1.0",
                                                                                                                "description": "Tracking milestone for version 1.0",
                                                                                                                "creator": {
                                                                                                                  "login": "octocat",
                                                                                                                  "id": 1,
                                                                                                                  "avatar_url": "https://github.com/images/error/octocat_happy.gif",
                                                                                                                  "gravatar_id": "",
                                                                                                                  "url": "https://api.github.com/users/octocat",
                                                                                                                  "html_url": "https://github.com/octocat",
                                                                                                                  "followers_url": "https://api.github.com/users/octocat/followers",
                                                                                                                  "following_url": "https://api.github.com/users/octocat/following{/other_user}",
                                                                                                                  "gists_url": "https://api.github.com/users/octocat/gists{/gist_id}",
                                                                                                                  "starred_url": "https://api.github.com/users/octocat/starred{/owner}{/repo}",
                                                                                                                  "subscriptions_url": "https://api.github.com/users/octocat/subscriptions",
                                                                                                                  "organizations_url": "https://api.github.com/users/octocat/orgs",
                                                                                                                  "repos_url": "https://api.github.com/users/octocat/repos",
                                                                                                                  "events_url": "https://api.github.com/users/octocat/events{/privacy}",
                                                                                                                  "received_events_url": "https://api.github.com/users/octocat/received_events",
                                                                                                                  "type": "User",
                                                                                                                  "site_admin": false
                                                                                                                },
                                                                                                                "open_issues": 4,
                                                                                                                "closed_issues": 8,
                                                                                                                "created_at": "2011-04-10T20:09:31Z",
                                                                                                                "updated_at": "2014-03-03T18:58:10Z",
                                                                                                                "closed_at": "2013-02-12T13:22:01Z",
                                                                                                                "due_on": "2012-10-09T23:39:01Z"
                                                                                                              },
                                                                                                              "locked": true,
                                                                                                              "active_lock_reason": "too heated",
                                                                                                              "comments": 0,
                                                                                                              "pull_request": {
                                                                                                                "url": "https://api.github.com/repos/octocat/Hello-World/pulls/1347",
                                                                                                                "html_url": "https://github.com/octocat/Hello-World/pull/1347",
                                                                                                                "diff_url": "https://github.com/octocat/Hello-World/pull/1347.diff",
                                                                                                                "patch_url": "https://github.com/octocat/Hello-World/pull/1347.patch"
                                                                                                              },
                                                                                                              "closed_at": null,
                                                                                                              "created_at": "2011-04-22T13:33:48Z",
                                                                                                              "updated_at": "2011-04-22T13:33:48Z"
                                                                                                            }
                                                                                                          }
                                                                                                          

                                                                                                          Issue events triggered by users via integrations

                                                                                                          Note: An additional performed_via_github_app object in the issue payload is currently available for developers to preview. For more information, see the related blog post.

                                                                                                          To access the API, you must provide a custom media type in the Accept header:

                                                                                                          application/vnd.github.machine-man-preview
                                                                                                          

                                                                                                          Note: If the event was triggered by a user via a GitHub App, the performed_via_github_app key will contain information on that GitHub App.

                                                                                                          Warning: The API may change without advance notice during the preview period. Preview features are not supported for production use. If you experience any issues, contact GitHub support.

                                                                                                          tmp/developer.github.com/v3/issues/labels/index.html Issue Labels | GitHub Developer Guide

                                                                                                          Labels

                                                                                                          Note: To help with migrating from our REST API v3 to GraphQL API v4, we're introducing a preview period to include the GraphQL node_id in the response for many REST API v3 resources. See the blog post for full details. To access node_id during the preview period, you must provide a custom media type in the Accept header:

                                                                                                          application/vnd.github.jean-grey-preview+json
                                                                                                          

                                                                                                          Warning: The API may change without advance notice during the preview period. Preview features are not supported for production use. If you experience any issues, contact GitHub support.

                                                                                                          List all labels for this repository

                                                                                                          GET /repos/:owner/:repo/labels
                                                                                                          

                                                                                                          Response

                                                                                                          Status: 200 OK
                                                                                                          Link: <https://api.github.com/resource?page=2>; rel="next",
                                                                                                                <https://api.github.com/resource?page=5>; rel="last"
                                                                                                          
                                                                                                          [
                                                                                                            {
                                                                                                              "id": 208045946,
                                                                                                              "url": "https://api.github.com/repos/octocat/Hello-World/labels/bug",
                                                                                                              "name": "bug",
                                                                                                              "color": "f29513",
                                                                                                              "default": true
                                                                                                            }
                                                                                                          ]
                                                                                                          

                                                                                                          Get a single label

                                                                                                          GET /repos/:owner/:repo/labels/:name
                                                                                                          

                                                                                                          Response

                                                                                                          Status: 200 OK
                                                                                                          
                                                                                                          {
                                                                                                            "id": 208045946,
                                                                                                            "url": "https://api.github.com/repos/octocat/Hello-World/labels/bug",
                                                                                                            "name": "bug",
                                                                                                            "color": "f29513",
                                                                                                            "default": true
                                                                                                          }
                                                                                                          

                                                                                                          Create a label

                                                                                                          POST /repos/:owner/:repo/labels
                                                                                                          

                                                                                                          Parameters

                                                                                                          Name Type Description
                                                                                                          name string Required. The name of the label.
                                                                                                          color string Required. A 6 character hex code, without the leading #, identifying the color.
                                                                                                          {
                                                                                                            "name": "bug",
                                                                                                            "color": "f29513"
                                                                                                          }
                                                                                                          

                                                                                                          Response

                                                                                                          Status: 201 Created
                                                                                                          Location: https://api.github.com/repos/octocat/Hello-World/labels/bug
                                                                                                          
                                                                                                          {
                                                                                                            "id": 208045946,
                                                                                                            "url": "https://api.github.com/repos/octocat/Hello-World/labels/bug",
                                                                                                            "name": "bug",
                                                                                                            "color": "f29513",
                                                                                                            "default": true
                                                                                                          }
                                                                                                          

                                                                                                          Update a label

                                                                                                          PATCH /repos/:owner/:repo/labels/:name
                                                                                                          

                                                                                                          Parameters

                                                                                                          Name Type Description
                                                                                                          name string The name of the label.
                                                                                                          color string A 6 character hex code, without the leading #, identifying the color.
                                                                                                          {
                                                                                                            "name": "bug",
                                                                                                            "color": "f29513"
                                                                                                          }
                                                                                                          

                                                                                                          Response

                                                                                                          Status: 200 OK
                                                                                                          
                                                                                                          {
                                                                                                            "id": 208045946,
                                                                                                            "url": "https://api.github.com/repos/octocat/Hello-World/labels/bug",
                                                                                                            "name": "bug",
                                                                                                            "color": "f29513",
                                                                                                            "default": true
                                                                                                          }
                                                                                                          

                                                                                                          Delete a label

                                                                                                          DELETE /repos/:owner/:repo/labels/:name
                                                                                                          

                                                                                                          Response

                                                                                                          Status: 204 No Content
                                                                                                          

                                                                                                          List labels on an issue

                                                                                                          GET /repos/:owner/:repo/issues/:number/labels
                                                                                                          

                                                                                                          Response

                                                                                                          Status: 200 OK
                                                                                                          Link: <https://api.github.com/resource?page=2>; rel="next",
                                                                                                                <https://api.github.com/resource?page=5>; rel="last"
                                                                                                          
                                                                                                          [
                                                                                                            {
                                                                                                              "id": 208045946,
                                                                                                              "url": "https://api.github.com/repos/octocat/Hello-World/labels/bug",
                                                                                                              "name": "bug",
                                                                                                              "color": "f29513",
                                                                                                              "default": true
                                                                                                            }
                                                                                                          ]
                                                                                                          

                                                                                                          Add labels to an issue

                                                                                                          POST /repos/:owner/:repo/issues/:number/labels
                                                                                                          

                                                                                                          Input

                                                                                                          [
                                                                                                            "Label1",
                                                                                                            "Label2"
                                                                                                          ]
                                                                                                          

                                                                                                          Response

                                                                                                          Status: 200 OK
                                                                                                          
                                                                                                          [
                                                                                                            {
                                                                                                              "id": 208045946,
                                                                                                              "url": "https://api.github.com/repos/octocat/Hello-World/labels/bug",
                                                                                                              "name": "bug",
                                                                                                              "color": "f29513",
                                                                                                              "default": true
                                                                                                            }
                                                                                                          ]
                                                                                                          

                                                                                                          Remove a label from an issue

                                                                                                          DELETE /repos/:owner/:repo/issues/:number/labels/:name
                                                                                                          

                                                                                                          Response if the label was removed successfully

                                                                                                          Status: 200 OK
                                                                                                          
                                                                                                          [
                                                                                                            {
                                                                                                              "id": 208045946,
                                                                                                              "url": "https://api.github.com/repos/octocat/Hello-World/labels/bug",
                                                                                                              "name": "bug",
                                                                                                              "color": "f29513",
                                                                                                              "default": true
                                                                                                            }
                                                                                                          ]
                                                                                                          

                                                                                                          Response if the label does not exist

                                                                                                          Status: 404 Not Found
                                                                                                          
                                                                                                          {
                                                                                                            "message": "Label does not exist",
                                                                                                            "documentation_url": "https://developer.github.com/v3"
                                                                                                          }
                                                                                                          

                                                                                                          Replace all labels for an issue

                                                                                                          PUT /repos/:owner/:repo/issues/:number/labels
                                                                                                          

                                                                                                          Input

                                                                                                          [
                                                                                                            "Label1",
                                                                                                            "Label2"
                                                                                                          ]
                                                                                                          

                                                                                                          Sending an empty array ([]) will remove all Labels from the Issue.

                                                                                                          Response

                                                                                                          Status: 200 OK
                                                                                                          
                                                                                                          [
                                                                                                            {
                                                                                                              "id": 208045946,
                                                                                                              "url": "https://api.github.com/repos/octocat/Hello-World/labels/bug",
                                                                                                              "name": "bug",
                                                                                                              "color": "f29513",
                                                                                                              "default": true
                                                                                                            }
                                                                                                          ]
                                                                                                          

                                                                                                          Remove all labels from an issue

                                                                                                          DELETE /repos/:owner/:repo/issues/:number/labels
                                                                                                          

                                                                                                          Response

                                                                                                          Status: 204 No Content
                                                                                                          

                                                                                                          Get labels for every issue in a milestone

                                                                                                          GET /repos/:owner/:repo/milestones/:number/labels
                                                                                                          

                                                                                                          Response

                                                                                                          Status: 200 OK
                                                                                                          Link: <https://api.github.com/resource?page=2>; rel="next",
                                                                                                                <https://api.github.com/resource?page=5>; rel="last"
                                                                                                          
                                                                                                          [
                                                                                                            {
                                                                                                              "id": 208045946,
                                                                                                              "url": "https://api.github.com/repos/octocat/Hello-World/labels/bug",
                                                                                                              "name": "bug",
                                                                                                              "color": "f29513",
                                                                                                              "default": true
                                                                                                            }
                                                                                                          ]
                                                                                                          
                                                                                                          tmp/developer.github.com/v3/issues/milestones/index.html Issue Milestones | GitHub Developer Guide

                                                                                                          Milestones

                                                                                                          Note: To help with migrating from our REST API v3 to GraphQL API v4, we're introducing a preview period to include the GraphQL node_id in the response for many REST API v3 resources. See the blog post for full details. To access node_id during the preview period, you must provide a custom media type in the Accept header:

                                                                                                          application/vnd.github.jean-grey-preview+json
                                                                                                          

                                                                                                          Warning: The API may change without advance notice during the preview period. Preview features are not supported for production use. If you experience any issues, contact GitHub support.

                                                                                                          List milestones for a repository

                                                                                                          GET /repos/:owner/:repo/milestones
                                                                                                          

                                                                                                          Parameters

                                                                                                          Name Type Description
                                                                                                          state string The state of the milestone. Either open, closed, or all. Default: open
                                                                                                          sort string What to sort results by. Either due_on or completeness. Default: due_on
                                                                                                          direction string The direction of the sort. Either asc or desc. Default: asc

                                                                                                          Response

                                                                                                          Status: 200 OK
                                                                                                          Link: <https://api.github.com/resource?page=2>; rel="next",
                                                                                                                <https://api.github.com/resource?page=5>; rel="last"
                                                                                                          
                                                                                                          [
                                                                                                            {
                                                                                                              "url": "https://api.github.com/repos/octocat/Hello-World/milestones/1",
                                                                                                              "html_url": "https://github.com/octocat/Hello-World/milestones/v1.0",
                                                                                                              "labels_url": "https://api.github.com/repos/octocat/Hello-World/milestones/1/labels",
                                                                                                              "id": 1002604,
                                                                                                              "number": 1,
                                                                                                              "state": "open",
                                                                                                              "title": "v1.0",
                                                                                                              "description": "Tracking milestone for version 1.0",
                                                                                                              "creator": {
                                                                                                                "login": "octocat",
                                                                                                                "id": 1,
                                                                                                                "avatar_url": "https://github.com/images/error/octocat_happy.gif",
                                                                                                                "gravatar_id": "",
                                                                                                                "url": "https://api.github.com/users/octocat",
                                                                                                                "html_url": "https://github.com/octocat",
                                                                                                                "followers_url": "https://api.github.com/users/octocat/followers",
                                                                                                                "following_url": "https://api.github.com/users/octocat/following{/other_user}",
                                                                                                                "gists_url": "https://api.github.com/users/octocat/gists{/gist_id}",
                                                                                                                "starred_url": "https://api.github.com/users/octocat/starred{/owner}{/repo}",
                                                                                                                "subscriptions_url": "https://api.github.com/users/octocat/subscriptions",
                                                                                                                "organizations_url": "https://api.github.com/users/octocat/orgs",
                                                                                                                "repos_url": "https://api.github.com/users/octocat/repos",
                                                                                                                "events_url": "https://api.github.com/users/octocat/events{/privacy}",
                                                                                                                "received_events_url": "https://api.github.com/users/octocat/received_events",
                                                                                                                "type": "User",
                                                                                                                "site_admin": false
                                                                                                              },
                                                                                                              "open_issues": 4,
                                                                                                              "closed_issues": 8,
                                                                                                              "created_at": "2011-04-10T20:09:31Z",
                                                                                                              "updated_at": "2014-03-03T18:58:10Z",
                                                                                                              "closed_at": "2013-02-12T13:22:01Z",
                                                                                                              "due_on": "2012-10-09T23:39:01Z"
                                                                                                            }
                                                                                                          ]
                                                                                                          

                                                                                                          Get a single milestone

                                                                                                          GET /repos/:owner/:repo/milestones/:number
                                                                                                          

                                                                                                          Response

                                                                                                          Status: 200 OK
                                                                                                          
                                                                                                          {
                                                                                                            "url": "https://api.github.com/repos/octocat/Hello-World/milestones/1",
                                                                                                            "html_url": "https://github.com/octocat/Hello-World/milestones/v1.0",
                                                                                                            "labels_url": "https://api.github.com/repos/octocat/Hello-World/milestones/1/labels",
                                                                                                            "id": 1002604,
                                                                                                            "number": 1,
                                                                                                            "state": "open",
                                                                                                            "title": "v1.0",
                                                                                                            "description": "Tracking milestone for version 1.0",
                                                                                                            "creator": {
                                                                                                              "login": "octocat",
                                                                                                              "id": 1,
                                                                                                              "avatar_url": "https://github.com/images/error/octocat_happy.gif",
                                                                                                              "gravatar_id": "",
                                                                                                              "url": "https://api.github.com/users/octocat",
                                                                                                              "html_url": "https://github.com/octocat",
                                                                                                              "followers_url": "https://api.github.com/users/octocat/followers",
                                                                                                              "following_url": "https://api.github.com/users/octocat/following{/other_user}",
                                                                                                              "gists_url": "https://api.github.com/users/octocat/gists{/gist_id}",
                                                                                                              "starred_url": "https://api.github.com/users/octocat/starred{/owner}{/repo}",
                                                                                                              "subscriptions_url": "https://api.github.com/users/octocat/subscriptions",
                                                                                                              "organizations_url": "https://api.github.com/users/octocat/orgs",
                                                                                                              "repos_url": "https://api.github.com/users/octocat/repos",
                                                                                                              "events_url": "https://api.github.com/users/octocat/events{/privacy}",
                                                                                                              "received_events_url": "https://api.github.com/users/octocat/received_events",
                                                                                                              "type": "User",
                                                                                                              "site_admin": false
                                                                                                            },
                                                                                                            "open_issues": 4,
                                                                                                            "closed_issues": 8,
                                                                                                            "created_at": "2011-04-10T20:09:31Z",
                                                                                                            "updated_at": "2014-03-03T18:58:10Z",
                                                                                                            "closed_at": "2013-02-12T13:22:01Z",
                                                                                                            "due_on": "2012-10-09T23:39:01Z"
                                                                                                          }
                                                                                                          

                                                                                                          Create a milestone

                                                                                                          POST /repos/:owner/:repo/milestones
                                                                                                          

                                                                                                          Input

                                                                                                          Name Type Description
                                                                                                          title string Required. The title of the milestone.
                                                                                                          state string The state of the milestone. Either open or closed. Default: open
                                                                                                          description string A description of the milestone.
                                                                                                          due_on string The milestone due date. This is a timestamp in ISO 8601 format: YYYY-MM-DDTHH:MM:SSZ.

                                                                                                          Example

                                                                                                          {
                                                                                                            "title": "v1.0",
                                                                                                            "state": "open",
                                                                                                            "description": "Tracking milestone for version 1.0",
                                                                                                            "due_on": "2012-10-09T23:39:01Z"
                                                                                                          }
                                                                                                          

                                                                                                          Response

                                                                                                          Status: 201 Created
                                                                                                          Location: https://api.github.com/repos/octocat/Hello-World/milestones/1
                                                                                                          
                                                                                                          {
                                                                                                            "url": "https://api.github.com/repos/octocat/Hello-World/milestones/1",
                                                                                                            "html_url": "https://github.com/octocat/Hello-World/milestones/v1.0",
                                                                                                            "labels_url": "https://api.github.com/repos/octocat/Hello-World/milestones/1/labels",
                                                                                                            "id": 1002604,
                                                                                                            "number": 1,
                                                                                                            "state": "open",
                                                                                                            "title": "v1.0",
                                                                                                            "description": "Tracking milestone for version 1.0",
                                                                                                            "creator": {
                                                                                                              "login": "octocat",
                                                                                                              "id": 1,
                                                                                                              "avatar_url": "https://github.com/images/error/octocat_happy.gif",
                                                                                                              "gravatar_id": "",
                                                                                                              "url": "https://api.github.com/users/octocat",
                                                                                                              "html_url": "https://github.com/octocat",
                                                                                                              "followers_url": "https://api.github.com/users/octocat/followers",
                                                                                                              "following_url": "https://api.github.com/users/octocat/following{/other_user}",
                                                                                                              "gists_url": "https://api.github.com/users/octocat/gists{/gist_id}",
                                                                                                              "starred_url": "https://api.github.com/users/octocat/starred{/owner}{/repo}",
                                                                                                              "subscriptions_url": "https://api.github.com/users/octocat/subscriptions",
                                                                                                              "organizations_url": "https://api.github.com/users/octocat/orgs",
                                                                                                              "repos_url": "https://api.github.com/users/octocat/repos",
                                                                                                              "events_url": "https://api.github.com/users/octocat/events{/privacy}",
                                                                                                              "received_events_url": "https://api.github.com/users/octocat/received_events",
                                                                                                              "type": "User",
                                                                                                              "site_admin": false
                                                                                                            },
                                                                                                            "open_issues": 4,
                                                                                                            "closed_issues": 8,
                                                                                                            "created_at": "2011-04-10T20:09:31Z",
                                                                                                            "updated_at": "2014-03-03T18:58:10Z",
                                                                                                            "closed_at": "2013-02-12T13:22:01Z",
                                                                                                            "due_on": "2012-10-09T23:39:01Z"
                                                                                                          }
                                                                                                          

                                                                                                          Update a milestone

                                                                                                          PATCH /repos/:owner/:repo/milestones/:number
                                                                                                          

                                                                                                          Input

                                                                                                          Name Type Description
                                                                                                          title string The title of the milestone.
                                                                                                          state string The state of the milestone. Either open or closed. Default: open
                                                                                                          description string A description of the milestone.
                                                                                                          due_on string The milestone due date. This is a timestamp in ISO 8601 format: YYYY-MM-DDTHH:MM:SSZ.

                                                                                                          Example

                                                                                                          {
                                                                                                            "title": "v1.0",
                                                                                                            "state": "open",
                                                                                                            "description": "Tracking milestone for version 1.0",
                                                                                                            "due_on": "2012-10-09T23:39:01Z"
                                                                                                          }
                                                                                                          

                                                                                                          Response

                                                                                                          Status: 200 OK
                                                                                                          
                                                                                                          {
                                                                                                            "url": "https://api.github.com/repos/octocat/Hello-World/milestones/1",
                                                                                                            "html_url": "https://github.com/octocat/Hello-World/milestones/v1.0",
                                                                                                            "labels_url": "https://api.github.com/repos/octocat/Hello-World/milestones/1/labels",
                                                                                                            "id": 1002604,
                                                                                                            "number": 1,
                                                                                                            "state": "open",
                                                                                                            "title": "v1.0",
                                                                                                            "description": "Tracking milestone for version 1.0",
                                                                                                            "creator": {
                                                                                                              "login": "octocat",
                                                                                                              "id": 1,
                                                                                                              "avatar_url": "https://github.com/images/error/octocat_happy.gif",
                                                                                                              "gravatar_id": "",
                                                                                                              "url": "https://api.github.com/users/octocat",
                                                                                                              "html_url": "https://github.com/octocat",
                                                                                                              "followers_url": "https://api.github.com/users/octocat/followers",
                                                                                                              "following_url": "https://api.github.com/users/octocat/following{/other_user}",
                                                                                                              "gists_url": "https://api.github.com/users/octocat/gists{/gist_id}",
                                                                                                              "starred_url": "https://api.github.com/users/octocat/starred{/owner}{/repo}",
                                                                                                              "subscriptions_url": "https://api.github.com/users/octocat/subscriptions",
                                                                                                              "organizations_url": "https://api.github.com/users/octocat/orgs",
                                                                                                              "repos_url": "https://api.github.com/users/octocat/repos",
                                                                                                              "events_url": "https://api.github.com/users/octocat/events{/privacy}",
                                                                                                              "received_events_url": "https://api.github.com/users/octocat/received_events",
                                                                                                              "type": "User",
                                                                                                              "site_admin": false
                                                                                                            },
                                                                                                            "open_issues": 4,
                                                                                                            "closed_issues": 8,
                                                                                                            "created_at": "2011-04-10T20:09:31Z",
                                                                                                            "updated_at": "2014-03-03T18:58:10Z",
                                                                                                            "closed_at": "2013-02-12T13:22:01Z",
                                                                                                            "due_on": "2012-10-09T23:39:01Z"
                                                                                                          }
                                                                                                          

                                                                                                          Delete a milestone

                                                                                                          DELETE /repos/:owner/:repo/milestones/:number
                                                                                                          

                                                                                                          Response

                                                                                                          Status: 204 No Content
                                                                                                          
                                                                                                          tmp/developer.github.com/v3/issues/timeline/index.html Issue Timeline | GitHub Developer Guide

                                                                                                          The API to get issue timeline events is currently available for developers to preview. During the preview period, the APIs may change without advance notice. Please see the blog post for full details.

                                                                                                          To access the API you must provide a custom media type in the Accept header:

                                                                                                            application/vnd.github.mockingbird-preview
                                                                                                          

                                                                                                          Timeline

                                                                                                          Records various events that occur around an issue or pull request. This is useful both for display on issue and pull request information pages, as well as to determine who should be notified of comments.

                                                                                                          Attributes

                                                                                                          id
                                                                                                          The Integer ID of the event.
                                                                                                          url
                                                                                                          The API URL for fetching the event.
                                                                                                          actor
                                                                                                          The User object that generated the event.
                                                                                                          commit_id
                                                                                                          The String SHA of a commit that referenced this Issue.
                                                                                                          event
                                                                                                          Identifies the actual type of Event that occurred.
                                                                                                          created_at
                                                                                                          The timestamp indicating when the event occurred.
                                                                                                          label
                                                                                                          The Label object including `name` and `color` attributes. Only provided for `labeled` and `unlabeled` events.
                                                                                                          assignee
                                                                                                          The User object which was assigned to (or unassigned from) this Issue. Only provided for `assigned` and `unassigned` events.
                                                                                                          dismissed_review
                                                                                                          A `dismissed_review` object that includes the `state`, `review_id`, `dismissal_message`, and `dismissal_commit_id` (the ID of the commit that dismissed the review) if one exists. Possible `state` strings include `commented`, `approved`, or `changes_requested`. Only provided for `review_dismissed` events.
                                                                                                          milestone
                                                                                                          The Milestone object including a `title` attribute. Only provided for `milestoned` and `demilestoned` events.
                                                                                                          source
                                                                                                          The `id`, `actor`, and `url` for the source of a reference from another issue. Only provided for `cross-referenced` events.
                                                                                                          rename
                                                                                                          An object containing rename details including `from` and `to` attributes. Only provided for `renamed` events.

                                                                                                          Events

                                                                                                          added_to_project
                                                                                                          The issue was added to a project board.
                                                                                                          assigned
                                                                                                          The issue was assigned to the assignee.
                                                                                                          closed
                                                                                                          The issue was closed by the actor. When the commit_id is present, it identifies the commit that closed the issue using "closes / fixes #NN" syntax.
                                                                                                          commented
                                                                                                          A comment was added to the issue.
                                                                                                          committed
                                                                                                          A commit was added to the pull request's `HEAD` branch. Only provided for pull requests.
                                                                                                          converted_note_to_issue
                                                                                                          The issue was created by converting a note in a project board to an issue.
                                                                                                          cross-referenced
                                                                                                          The issue was referenced from another issue. The `source` attribute contains the `id`, `actor`, and `url` of the reference's source.
                                                                                                          demilestoned
                                                                                                          The issue was removed from a milestone.
                                                                                                          head_ref_deleted
                                                                                                          The pull request's branch was deleted.
                                                                                                          head_ref_restored
                                                                                                          The pull request's branch was restored.
                                                                                                          labeled
                                                                                                          A label was added to the issue.
                                                                                                          locked
                                                                                                          The issue was locked by the actor.
                                                                                                          marked_as_duplicate
                                                                                                          A user with write permissions marked an issue as a duplicate of another issue or a pull request as a duplicate of another pull request.
                                                                                                          mentioned
                                                                                                          The actor was @mentioned in an issue body.
                                                                                                          merged
                                                                                                          The issue was merged by the actor. The `commit_id` attribute is the SHA1 of the HEAD commit that was merged.
                                                                                                          milestoned
                                                                                                          The issue was added to a milestone.
                                                                                                          moved_columns_in_project
                                                                                                          The issue was moved between columns in a project board.
                                                                                                          referenced
                                                                                                          The issue was referenced from a commit message. The `commit_id` attribute is the commit SHA1 of where that happened.
                                                                                                          removed_from_project
                                                                                                          The issue was removed from a project board.
                                                                                                          renamed
                                                                                                          The issue title was changed.
                                                                                                          reopened
                                                                                                          The issue was reopened by the actor.
                                                                                                          review_dismissed
                                                                                                          The actor dismissed a review from the pull request.
                                                                                                          review_requested
                                                                                                          The actor requested a review from the subject on this pull request.
                                                                                                          review_request_removed
                                                                                                          The actor removed the review request for the subject on this pull request.
                                                                                                          subscribed
                                                                                                          The actor subscribed to receive notifications for an issue.
                                                                                                          unassigned
                                                                                                          The assignee was unassigned from the issue.
                                                                                                          unlabeled
                                                                                                          A label was removed from the issue.
                                                                                                          unlocked
                                                                                                          The issue was unlocked by the actor.
                                                                                                          unmarked_as_duplicate
                                                                                                          An issue that a user had previously marked as a duplicate of another issue is no longer considered a duplicate, or a pull request that a user had previously marked as a duplicate of another pull request is no longer considered a duplicate.
                                                                                                          unsubscribed
                                                                                                          The actor unsubscribed to stop receiving notifications for an issue.

                                                                                                          Note: The project-related events added_to_project, moved_columns_in_project, removed_from_project, and converted_note_to_issue will not be included in the response if project boards have been disabled in the repository.

                                                                                                          List events for an issue

                                                                                                          GET /repos/:owner/:repo/issues/:number/timeline
                                                                                                          

                                                                                                          Response

                                                                                                          Status: 200 OK
                                                                                                          Link: <https://api.github.com/resource?page=2>; rel="next",
                                                                                                                <https://api.github.com/resource?page=5>; rel="last"
                                                                                                          
                                                                                                          [
                                                                                                            {
                                                                                                              "id": 1,
                                                                                                              "url": "https://api.github.com/repos/octocat/Hello-World/issues/events/1",
                                                                                                              "actor": {
                                                                                                                "login": "octocat",
                                                                                                                "id": 1,
                                                                                                                "avatar_url": "https://github.com/images/error/octocat_happy.gif",
                                                                                                                "gravatar_id": "",
                                                                                                                "url": "https://api.github.com/users/octocat",
                                                                                                                "html_url": "https://github.com/octocat",
                                                                                                                "followers_url": "https://api.github.com/users/octocat/followers",
                                                                                                                "following_url": "https://api.github.com/users/octocat/following{/other_user}",
                                                                                                                "gists_url": "https://api.github.com/users/octocat/gists{/gist_id}",
                                                                                                                "starred_url": "https://api.github.com/users/octocat/starred{/owner}{/repo}",
                                                                                                                "subscriptions_url": "https://api.github.com/users/octocat/subscriptions",
                                                                                                                "organizations_url": "https://api.github.com/users/octocat/orgs",
                                                                                                                "repos_url": "https://api.github.com/users/octocat/repos",
                                                                                                                "events_url": "https://api.github.com/users/octocat/events{/privacy}",
                                                                                                                "received_events_url": "https://api.github.com/users/octocat/received_events",
                                                                                                                "type": "User",
                                                                                                                "site_admin": false
                                                                                                              },
                                                                                                              "event": "closed",
                                                                                                              "commit_id": "6dcb09b5b57875f334f61aebed695e2e4193db5e",
                                                                                                              "commit_url": "https://api.github.com/repos/octocat/Hello-World/commits/6dcb09b5b57875f334f61aebed695e2e4193db5e",
                                                                                                              "created_at": "2011-04-14T16:00:49Z"
                                                                                                            }
                                                                                                          ]
                                                                                                          
                                                                                                          tmp/developer.github.com/v3/libraries/index.html Libraries | GitHub Developer Guide
                                                                                                          The Gundamcat

                                                                                                          Octokit comes in
                                                                                                          many flavors

                                                                                                          Use the official Octokit library, or choose between any of the available third party libraries.

                                                                                                          Third-party libraries

                                                                                                          Clojure

                                                                                                          Dart

                                                                                                          Emacs Lisp

                                                                                                          Erlang

                                                                                                          Go

                                                                                                          Haskell

                                                                                                          Java

                                                                                                          JavaScript

                                                                                                          Julia

                                                                                                          OCaml

                                                                                                          Perl

                                                                                                          PHP

                                                                                                          Python

                                                                                                          Ruby

                                                                                                          Scala

                                                                                                          Shell

                                                                                                          tmp/developer.github.com/v3/licenses/index.html Licenses | GitHub Developer Guide

                                                                                                          Licenses

                                                                                                          The Licenses API returns metadata about popular open source licenses and information about a particular project's license file.

                                                                                                          The Licenses API uses the open source Ruby Gem Licensee to attempt to identify the project's license. Licensee matches the contents of a project's LICENSE file (if it exists) against a short list of known licenses. As a result, the API does not take into account the licenses of project dependencies or other means of documenting a project's license such as references to the license name in the documentation.

                                                                                                          If a license is matched, the license key and name returned conforms to the SPDX specification.

                                                                                                          Note: These endpoints will also return a repository's license information:

                                                                                                          GitHub is a lot of things, but it’s not a law firm. As such, GitHub does not provide legal advice. Using the Licenses API or sending us an email about it does not constitute legal advice nor does it create an attorney-client relationship. If you have any questions about what you can and can't do with a particular license, you should consult with your own legal counsel before moving forward. In fact, you should always consult with your own lawyer before making any decisions that might have legal ramifications or that may impact your legal rights.

                                                                                                          GitHub created the License API to help users get information about open source licenses and the projects that use them. We hope it helps, but please keep in mind that we’re not lawyers (at least not most of us aren't) and that we make mistakes like everyone else. For that reason, GitHub provides the API on an “as-is” basis and makes no warranties regarding any information or licenses provided on or through it, and disclaims liability for damages resulting from using the API.

                                                                                                          List all licenses

                                                                                                          GET /licenses
                                                                                                          

                                                                                                          Response

                                                                                                          Status: 200 OK
                                                                                                          
                                                                                                          [
                                                                                                            {
                                                                                                              "key": "mit",
                                                                                                              "name": "MIT License",
                                                                                                              "spdx_id": "MIT",
                                                                                                              "url": "https://api.github.com/licenses/mit",
                                                                                                              "html_url": "http://choosealicense.com/licenses/mit/"
                                                                                                            },
                                                                                                            {
                                                                                                              "key": "lgpl-3.0",
                                                                                                              "name": "GNU Lesser General Public License v3.0",
                                                                                                              "spdx_id": "LGPL-3.0",
                                                                                                              "url": "https://api.github.com/licenses/lgpl-3.0"
                                                                                                            },
                                                                                                            {
                                                                                                              "key": "mpl-2.0",
                                                                                                              "name": "Mozilla Public License 2.0",
                                                                                                              "spdx_id": "MPL-2.0",
                                                                                                              "url": "https://api.github.com/licenses/mpl-2.0"
                                                                                                            },
                                                                                                            {
                                                                                                              "key": "agpl-3.0",
                                                                                                              "name": "GNU Affero General Public License v3.0",
                                                                                                              "spdx_id": "AGPL-3.0",
                                                                                                              "url": "https://api.github.com/licenses/agpl-3.0"
                                                                                                            },
                                                                                                            {
                                                                                                              "key": "unlicense",
                                                                                                              "name": "The Unlicense",
                                                                                                              "spdx_id": "Unlicense",
                                                                                                              "url": "https://api.github.com/licenses/unlicense"
                                                                                                            },
                                                                                                            {
                                                                                                              "key": "apache-2.0",
                                                                                                              "name": "Apache License 2.0",
                                                                                                              "spdx_id": "Apache-2.0",
                                                                                                              "url": "https://api.github.com/licenses/apache-2.0"
                                                                                                            },
                                                                                                            {
                                                                                                              "key": "gpl-3.0",
                                                                                                              "name": "GNU General Public License v3.0",
                                                                                                              "spdx_id": "GPL-3.0",
                                                                                                              "url": "https://api.github.com/licenses/gpl-3.0"
                                                                                                            }
                                                                                                          ]
                                                                                                          

                                                                                                          Get an individual license

                                                                                                          GET /licenses/:license
                                                                                                          

                                                                                                          Response

                                                                                                          Status: 200 OK
                                                                                                          
                                                                                                          {
                                                                                                            "key": "mit",
                                                                                                            "name": "MIT License",
                                                                                                            "spdx_id": "MIT",
                                                                                                            "url": "https://api.github.com/licenses/mit",
                                                                                                            "html_url": "http://choosealicense.com/licenses/mit/",
                                                                                                            "description": "A permissive license that is short and to the point. It lets people do anything with your code with proper attribution and without warranty.",
                                                                                                            "implementation": "Create a text file (typically named LICENSE or LICENSE.txt) in the root of your source code and copy the text of the license into the file. Replace [year] with the current year and [fullname] with the name (or names) of the copyright holders.",
                                                                                                            "permissions": [
                                                                                                              "commercial-use",
                                                                                                              "modifications",
                                                                                                              "distribution",
                                                                                                              "sublicense",
                                                                                                              "private-use"
                                                                                                            ],
                                                                                                            "conditions": [
                                                                                                              "include-copyright"
                                                                                                            ],
                                                                                                            "limitations": [
                                                                                                              "no-liability"
                                                                                                            ],
                                                                                                            "body": "\n\nThe MIT License (MIT)\n\nCopyright (c) [year] [fullname]\n\nPermission is hereby granted, free of charge, to any person obtaining a copy\nof this software and associated documentation files (the \"Software\"), to deal\nin the Software without restriction, including without limitation the rights\nto use, copy, modify, merge, publish, distribute, sublicense, and/or sell\ncopies of the Software, and to permit persons to whom the Software is\nfurnished to do so, subject to the following conditions:\n\nThe above copyright notice and this permission notice shall be included in all\ncopies or substantial portions of the Software.\n\nTHE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\nIMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\nFITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\nAUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\nLIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\nOUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE\nSOFTWARE.\n"
                                                                                                          }
                                                                                                          

                                                                                                          Get the contents of a repository's license

                                                                                                          This method returns the contents of the repository's license file, if one is detected.

                                                                                                          GET /repos/:owner/:repo/license
                                                                                                          

                                                                                                          Similar to the repository contents API, this method also supports custom media types for retrieving the raw license content or rendered license HTML.

                                                                                                          Response

                                                                                                          Status: 200 OK
                                                                                                          
                                                                                                          {
                                                                                                            "name": "LICENSE",
                                                                                                            "path": "LICENSE",
                                                                                                            "sha": "401c59dcc4570b954dd6d345e76199e1f4e76266",
                                                                                                            "size": 1077,
                                                                                                            "url": "https://api.github.com/repos/benbalter/gman/contents/LICENSE?ref=master",
                                                                                                            "html_url": "https://github.com/benbalter/gman/blob/master/LICENSE",
                                                                                                            "git_url": "https://api.github.com/repos/benbalter/gman/git/blobs/401c59dcc4570b954dd6d345e76199e1f4e76266",
                                                                                                            "download_url": "https://raw.githubusercontent.com/benbalter/gman/master/LICENSE?lab=true",
                                                                                                            "type": "file",
                                                                                                            "content": "VGhlIE1JVCBMaWNlbnNlIChNSVQpCgpDb3B5cmlnaHQgKGMpIDIwMTMgQmVu\nIEJhbHRlcgoKUGVybWlzc2lvbiBpcyBoZXJlYnkgZ3JhbnRlZCwgZnJlZSBv\nZiBjaGFyZ2UsIHRvIGFueSBwZXJzb24gb2J0YWluaW5nIGEgY29weSBvZgp0\naGlzIHNvZnR3YXJlIGFuZCBhc3NvY2lhdGVkIGRvY3VtZW50YXRpb24gZmls\nZXMgKHRoZSAiU29mdHdhcmUiKSwgdG8gZGVhbCBpbgp0aGUgU29mdHdhcmUg\nd2l0aG91dCByZXN0cmljdGlvbiwgaW5jbHVkaW5nIHdpdGhvdXQgbGltaXRh\ndGlvbiB0aGUgcmlnaHRzIHRvCnVzZSwgY29weSwgbW9kaWZ5LCBtZXJnZSwg\ncHVibGlzaCwgZGlzdHJpYnV0ZSwgc3VibGljZW5zZSwgYW5kL29yIHNlbGwg\nY29waWVzIG9mCnRoZSBTb2Z0d2FyZSwgYW5kIHRvIHBlcm1pdCBwZXJzb25z\nIHRvIHdob20gdGhlIFNvZnR3YXJlIGlzIGZ1cm5pc2hlZCB0byBkbyBzbywK\nc3ViamVjdCB0byB0aGUgZm9sbG93aW5nIGNvbmRpdGlvbnM6CgpUaGUgYWJv\ndmUgY29weXJpZ2h0IG5vdGljZSBhbmQgdGhpcyBwZXJtaXNzaW9uIG5vdGlj\nZSBzaGFsbCBiZSBpbmNsdWRlZCBpbiBhbGwKY29waWVzIG9yIHN1YnN0YW50\naWFsIHBvcnRpb25zIG9mIHRoZSBTb2Z0d2FyZS4KClRIRSBTT0ZUV0FSRSBJ\nUyBQUk9WSURFRCAiQVMgSVMiLCBXSVRIT1VUIFdBUlJBTlRZIE9GIEFOWSBL\nSU5ELCBFWFBSRVNTIE9SCklNUExJRUQsIElOQ0xVRElORyBCVVQgTk9UIExJ\nTUlURUQgVE8gVEhFIFdBUlJBTlRJRVMgT0YgTUVSQ0hBTlRBQklMSVRZLCBG\nSVRORVNTCkZPUiBBIFBBUlRJQ1VMQVIgUFVSUE9TRSBBTkQgTk9OSU5GUklO\nR0VNRU5ULiBJTiBOTyBFVkVOVCBTSEFMTCBUSEUgQVVUSE9SUyBPUgpDT1BZ\nUklHSFQgSE9MREVSUyBCRSBMSUFCTEUgRk9SIEFOWSBDTEFJTSwgREFNQUdF\nUyBPUiBPVEhFUiBMSUFCSUxJVFksIFdIRVRIRVIKSU4gQU4gQUNUSU9OIE9G\nIENPTlRSQUNULCBUT1JUIE9SIE9USEVSV0lTRSwgQVJJU0lORyBGUk9NLCBP\nVVQgT0YgT1IgSU4KQ09OTkVDVElPTiBXSVRIIFRIRSBTT0ZUV0FSRSBPUiBU\nSEUgVVNFIE9SIE9USEVSIERFQUxJTkdTIElOIFRIRSBTT0ZUV0FSRS4K\n",
                                                                                                            "encoding": "base64",
                                                                                                            "_links": {
                                                                                                              "self": "https://api.github.com/repos/benbalter/gman/contents/LICENSE?ref=master",
                                                                                                              "git": "https://api.github.com/repos/benbalter/gman/git/blobs/401c59dcc4570b954dd6d345e76199e1f4e76266",
                                                                                                              "html": "https://github.com/benbalter/gman/blob/master/LICENSE"
                                                                                                            },
                                                                                                            "license": {
                                                                                                              "key": "mit",
                                                                                                              "name": "MIT License",
                                                                                                              "spdx_id": "MIT",
                                                                                                              "url": "https://api.github.com/licenses/mit",
                                                                                                              "html_url": "http://choosealicense.com/licenses/mit/"
                                                                                                            }
                                                                                                          }
                                                                                                          
                                                                                                          tmp/developer.github.com/v3/markdown/index.html Markdown | GitHub Developer Guide

                                                                                                          Markdown

                                                                                                          Render an arbitrary Markdown document

                                                                                                          POST /markdown
                                                                                                          

                                                                                                          Parameters

                                                                                                          Name Type Description
                                                                                                          text string Required. The Markdown text to render in HTML. Markdown content must be 400 KB or less.
                                                                                                          mode string The rendering mode. Can be either:
                                                                                                          * markdown to render a document in plain Markdown, just like README.md files are rendered.
                                                                                                          * gfm to render a document in GitHub Flavored Markdown, which creates links for user mentions as well as references to SHA-1 hashes, issues, and pull requests.
                                                                                                          Default: markdown
                                                                                                          context string The repository context to use when creating references in gfm mode. Omit this parameter when using markdown mode.

                                                                                                          Example

                                                                                                          {
                                                                                                            "text": "Hello world github/linguist#1 **cool**, and #1!",
                                                                                                            "mode": "gfm",
                                                                                                            "context": "github/gollum"
                                                                                                          }
                                                                                                          

                                                                                                          Response

                                                                                                          Status: 200 OK
                                                                                                          Content-Type: text/html
                                                                                                          Content-Length: 279
                                                                                                          X-CommonMarker-Version: 0.17.4
                                                                                                          
                                                                                                          <p>Hello world <a href="http://github.com/github/linguist/issues/1" class="issue-link" title="This is a simple issue">github/linguist#1</a> <strong>cool</strong>, and <a href="http://github.com/github/gollum/issues/1" class="issue-link" title="This is another issue">#1</a>!</p>

                                                                                                          Render a Markdown document in raw mode

                                                                                                          POST /markdown/raw
                                                                                                          

                                                                                                          Parameters

                                                                                                          You must send Markdown as plain text (using a Content-Type header of text/plain or text/x-markdown) to this endpoint, rather than using JSON format. In raw mode, GitHub Flavored Markdown is not supported and Markdown will be rendered in plain format like a README.md file. Markdown content must be 400 KB or less.

                                                                                                          Example

                                                                                                          curl https://api.github.com/markdown/raw -X "POST" -H "Content-Type: text/plain" -d "Hello world github/linguist#1 cool, and #1!"
                                                                                                          

                                                                                                          Response

                                                                                                          Status: 200 OK
                                                                                                          Content-Type: text/html
                                                                                                          Content-Length: 68
                                                                                                          X-CommonMarker-Version: 0.17.4
                                                                                                          
                                                                                                          <p>Hello world github/linguist#1 <strong>cool</strong>, and #1!</p>
                                                                                                          tmp/developer.github.com/v3/media/index.html Media Types | GitHub Developer Guide

                                                                                                          Media Types

                                                                                                          Custom media types are used in the API to let consumers choose the format of the data they wish to receive. This is done by adding one or more of the following types to the Accept header when you make a request. Media types are specific to resources, allowing them to change independently and support formats that other resources don't.

                                                                                                          All GitHub media types look like this:

                                                                                                          application/vnd.github[.version].param[+json]
                                                                                                          

                                                                                                          The most basic media types the API supports are:

                                                                                                          application/json
                                                                                                          application/vnd.github+json
                                                                                                          

                                                                                                          Neither of these specify a version, so you will always get the current default JSON representation of resources.

                                                                                                          Important: The default version of the API may change in the future. If you're building an application and care about the stability of the API, be sure to request a specific version in the Accept header as shown in the examples below.

                                                                                                          You can specify a version like so:

                                                                                                          application/vnd.github.v3+json
                                                                                                          

                                                                                                          If you're specifying a property (such as full/raw/etc defined below), put the version before the property:

                                                                                                          application/vnd.github.v3.raw+json
                                                                                                          

                                                                                                          You can check the current version through every response's headers. Look for the X-GitHub-Media-Type header:

                                                                                                          curl https://api.github.com/users/technoweenie -I
                                                                                                          HTTP/1.1 200 OK
                                                                                                          X-GitHub-Media-Type: github.v3
                                                                                                          
                                                                                                          curl https://api.github.com/users/technoweenie -I \
                                                                                                           -H "Accept: application/vnd.github.full+json"
                                                                                                          HTTP/1.1 200 OK
                                                                                                          X-GitHub-Media-Type: github.v3; param=full; format=json
                                                                                                          
                                                                                                          curl https://api.github.com/users/technoweenie -I \
                                                                                                           -H "Accept: application/vnd.github.v3.full+json"
                                                                                                          HTTP/1.1 200 OK
                                                                                                          X-GitHub-Media-Type: github.v3; param=full; format=json
                                                                                                          

                                                                                                          Comment Body Properties

                                                                                                          The body of a comment can be written in GitHub Flavored Markdown. Issues, Issue Comments, Pull Request Comments, and Gist Comments all accept these same media types:

                                                                                                          Raw

                                                                                                          application/vnd.github.VERSION.raw+json
                                                                                                          

                                                                                                          Return the raw markdown body. Response will include body. This is the default if you do not pass any specific media type.

                                                                                                          Text

                                                                                                          application/vnd.github.VERSION.text+json
                                                                                                          

                                                                                                          Return a text only representation of the markdown body. Response will include body_text.

                                                                                                          HTML

                                                                                                          application/vnd.github.VERSION.html+json
                                                                                                          

                                                                                                          Return HTML rendered from the body's markdown. Response will include body_html.

                                                                                                          Full

                                                                                                          application/vnd.github.VERSION.full+json
                                                                                                          

                                                                                                          Return raw, text and HTML representations. Response will include body, body_text, and body_html:

                                                                                                          Git Blob Properties

                                                                                                          The following media types are allowed when getting a blob:

                                                                                                          JSON

                                                                                                          application/vnd.github.VERSION+json
                                                                                                          application/json
                                                                                                          

                                                                                                          Return JSON representation of the blob with content as a base64 encoded string. This is the default if nothing is passed.

                                                                                                          Raw

                                                                                                          application/vnd.github.VERSION.raw
                                                                                                          

                                                                                                          Return the raw blob data.

                                                                                                          Commits, Commit comparison, and Pull Requests

                                                                                                          The Commit, Commit Comparison, and Pull Request resources support diff and patch formats:

                                                                                                          diff

                                                                                                          application/vnd.github.VERSION.diff
                                                                                                          

                                                                                                          patch

                                                                                                          application/vnd.github.VERSION.patch
                                                                                                          

                                                                                                          sha

                                                                                                          application/vnd.github.VERSION.sha
                                                                                                          

                                                                                                          Repository contents

                                                                                                          Raw

                                                                                                          application/vnd.github.VERSION.raw
                                                                                                          

                                                                                                          Return the raw contents of a file. This is the default if you do not pass any specific media type.

                                                                                                          HTML

                                                                                                          application/vnd.github.VERSION.html
                                                                                                          

                                                                                                          For markup files such as Markdown or AsciiDoc, you can retrieve the rendered HTML using the .html media type. Markup languages are rendered to HTML using our open-source Markup library.

                                                                                                          Gists

                                                                                                          Raw

                                                                                                          application/vnd.github.VERSION.raw
                                                                                                          

                                                                                                          Return the raw contents of a gist. This is the default if you do not pass any specific media type.

                                                                                                          base64

                                                                                                          application/vnd.github.VERSION.base64
                                                                                                          

                                                                                                          The gist contents are base64-encoded before being sent out. This can be useful if your gist contains any invalid UTF-8 sequences.

                                                                                                          tmp/developer.github.com/v3/meta/index.html Meta | GitHub Developer Guide

                                                                                                          Meta

                                                                                                          This endpoint provides information about GitHub.com, the service.

                                                                                                          GET /meta
                                                                                                          

                                                                                                          Response

                                                                                                          Status: 200 OK
                                                                                                          
                                                                                                          {
                                                                                                            "verifiable_password_authentication": true,
                                                                                                            "github_services_sha": "3a0f86fb8db8eea7ccbb9a95f325ddbedfb25e15",
                                                                                                            "hooks": [
                                                                                                              "127.0.0.1/32"
                                                                                                            ],
                                                                                                            "git": [
                                                                                                              "127.0.0.1/32"
                                                                                                            ],
                                                                                                            "pages": [
                                                                                                              "192.30.252.153/32",
                                                                                                              "192.30.252.154/32"
                                                                                                            ],
                                                                                                            "importer": [
                                                                                                              "54.158.161.132",
                                                                                                              "54.226.70.38"
                                                                                                            ]
                                                                                                          }
                                                                                                          

                                                                                                          Body

                                                                                                          Name Type Description
                                                                                                          verifiable_password_authentication boolean Whether authentication with username and password is supported.
                                                                                                          github_services_sha string The currently-deployed SHA of github-services.
                                                                                                          hooks array of strings An Array of IP addresses in CIDR format specifying the addresses that incoming service hooks will originate from on GitHub.com. Subscribe to the API Changes blog or follow @GitHubAPI on Twitter to get updated when this list changes.
                                                                                                          git array of strings An Array of IP addresses in CIDR format specifying the Git servers for GitHub.com.
                                                                                                          pages array of strings An Array of IP addresses in CIDR format specifying the A records for GitHub Pages.
                                                                                                          importer array of strings An Array of IP addresses specifying the addresses that source imports will originate from on GitHub.com.
                                                                                                          tmp/developer.github.com/v3/migration/index.html Migration | GitHub Developer Guide

                                                                                                          Migration

                                                                                                          These APIs help you move projects to or from GitHub.

                                                                                                          Enterprise Migrations

                                                                                                          The Enterprise Migrations API lets you move a repository from GitHub to GitHub Enterprise.

                                                                                                          Source Imports

                                                                                                          The Source Imports API lets you import a source repository to GitHub.

                                                                                                          tmp/developer.github.com/v3/migration/migrations/index.html Migrations | GitHub Developer Guide

                                                                                                          Migrations

                                                                                                          The Migrations API is only available to authenticated organization owners.

                                                                                                          To access the Migrations API, you must provide a custom media type in the Accept header:

                                                                                                            application/vnd.github.wyandotte-preview+json
                                                                                                          

                                                                                                          Start a migration

                                                                                                          Initiates the generation of a migration archive.

                                                                                                          POST /orgs/:org/migrations
                                                                                                          

                                                                                                          Parameters

                                                                                                          Name Type Description
                                                                                                          repositories array of strings Required. A list of arrays indicating which repositories should be migrated.
                                                                                                          lock_repositories boolean Indicates whether repositories should be locked (to prevent manipulation) while migrating data. Default: false.
                                                                                                          exclude_attachments boolean Indicates whether attachments should be excluded from the migration (to reduce migration archive file size). Default: false.

                                                                                                          Example

                                                                                                          {
                                                                                                            "repositories": [
                                                                                                              "octocat/Hello-World"
                                                                                                            ],
                                                                                                            "lock_repositories": true
                                                                                                          }
                                                                                                          

                                                                                                          Response

                                                                                                          Status: 201 Created
                                                                                                          
                                                                                                          {
                                                                                                            "id": 79,
                                                                                                            "guid": "0b989ba4-242f-11e5-81e1-c7b6966d2516",
                                                                                                            "state": "pending",
                                                                                                            "lock_repositories": true,
                                                                                                            "exclude_attachments": false,
                                                                                                            "url": "https://api.github.com/orgs/octo-org/migrations/79",
                                                                                                            "created_at": "2015-07-06T15:33:38-07:00",
                                                                                                            "updated_at": "2015-07-06T15:33:38-07:00",
                                                                                                            "repositories": [
                                                                                                              {
                                                                                                                "id": 1296269,
                                                                                                                "owner": {
                                                                                                                  "login": "octocat",
                                                                                                                  "id": 1,
                                                                                                                  "avatar_url": "https://github.com/images/error/octocat_happy.gif",
                                                                                                                  "gravatar_id": "",
                                                                                                                  "url": "https://api.github.com/users/octocat",
                                                                                                                  "html_url": "https://github.com/octocat",
                                                                                                                  "followers_url": "https://api.github.com/users/octocat/followers",
                                                                                                                  "following_url": "https://api.github.com/users/octocat/following{/other_user}",
                                                                                                                  "gists_url": "https://api.github.com/users/octocat/gists{/gist_id}",
                                                                                                                  "starred_url": "https://api.github.com/users/octocat/starred{/owner}{/repo}",
                                                                                                                  "subscriptions_url": "https://api.github.com/users/octocat/subscriptions",
                                                                                                                  "organizations_url": "https://api.github.com/users/octocat/orgs",
                                                                                                                  "repos_url": "https://api.github.com/users/octocat/repos",
                                                                                                                  "events_url": "https://api.github.com/users/octocat/events{/privacy}",
                                                                                                                  "received_events_url": "https://api.github.com/users/octocat/received_events",
                                                                                                                  "type": "User",
                                                                                                                  "site_admin": false
                                                                                                                },
                                                                                                                "name": "Hello-World",
                                                                                                                "full_name": "octocat/Hello-World",
                                                                                                                "description": "This your first repo!",
                                                                                                                "private": false,
                                                                                                                "fork": false,
                                                                                                                "url": "https://api.github.com/repos/octocat/Hello-World",
                                                                                                                "html_url": "https://github.com/octocat/Hello-World",
                                                                                                                "archive_url": "http://api.github.com/repos/octocat/Hello-World/{archive_format}{/ref}",
                                                                                                                "assignees_url": "http://api.github.com/repos/octocat/Hello-World/assignees{/user}",
                                                                                                                "blobs_url": "http://api.github.com/repos/octocat/Hello-World/git/blobs{/sha}",
                                                                                                                "branches_url": "http://api.github.com/repos/octocat/Hello-World/branches{/branch}",
                                                                                                                "clone_url": "https://github.com/octocat/Hello-World.git",
                                                                                                                "collaborators_url": "http://api.github.com/repos/octocat/Hello-World/collaborators{/collaborator}",
                                                                                                                "comments_url": "http://api.github.com/repos/octocat/Hello-World/comments{/number}",
                                                                                                                "commits_url": "http://api.github.com/repos/octocat/Hello-World/commits{/sha}",
                                                                                                                "compare_url": "http://api.github.com/repos/octocat/Hello-World/compare/{base}...{head}",
                                                                                                                "contents_url": "http://api.github.com/repos/octocat/Hello-World/contents/{+path}",
                                                                                                                "contributors_url": "http://api.github.com/repos/octocat/Hello-World/contributors",
                                                                                                                "deployments_url": "http://api.github.com/repos/octocat/Hello-World/deployments",
                                                                                                                "downloads_url": "http://api.github.com/repos/octocat/Hello-World/downloads",
                                                                                                                "events_url": "http://api.github.com/repos/octocat/Hello-World/events",
                                                                                                                "forks_url": "http://api.github.com/repos/octocat/Hello-World/forks",
                                                                                                                "git_commits_url": "http://api.github.com/repos/octocat/Hello-World/git/commits{/sha}",
                                                                                                                "git_refs_url": "http://api.github.com/repos/octocat/Hello-World/git/refs{/sha}",
                                                                                                                "git_tags_url": "http://api.github.com/repos/octocat/Hello-World/git/tags{/sha}",
                                                                                                                "git_url": "git:github.com/octocat/Hello-World.git",
                                                                                                                "hooks_url": "http://api.github.com/repos/octocat/Hello-World/hooks",
                                                                                                                "issue_comment_url": "http://api.github.com/repos/octocat/Hello-World/issues/comments{/number}",
                                                                                                                "issue_events_url": "http://api.github.com/repos/octocat/Hello-World/issues/events{/number}",
                                                                                                                "issues_url": "http://api.github.com/repos/octocat/Hello-World/issues{/number}",
                                                                                                                "keys_url": "http://api.github.com/repos/octocat/Hello-World/keys{/key_id}",
                                                                                                                "labels_url": "http://api.github.com/repos/octocat/Hello-World/labels{/name}",
                                                                                                                "languages_url": "http://api.github.com/repos/octocat/Hello-World/languages",
                                                                                                                "merges_url": "http://api.github.com/repos/octocat/Hello-World/merges",
                                                                                                                "milestones_url": "http://api.github.com/repos/octocat/Hello-World/milestones{/number}",
                                                                                                                "mirror_url": "git:git.example.com/octocat/Hello-World",
                                                                                                                "notifications_url": "http://api.github.com/repos/octocat/Hello-World/notifications{?since,all,participating}",
                                                                                                                "pulls_url": "http://api.github.com/repos/octocat/Hello-World/pulls{/number}",
                                                                                                                "releases_url": "http://api.github.com/repos/octocat/Hello-World/releases{/id}",
                                                                                                                "ssh_url": "git@github.com:octocat/Hello-World.git",
                                                                                                                "stargazers_url": "http://api.github.com/repos/octocat/Hello-World/stargazers",
                                                                                                                "statuses_url": "http://api.github.com/repos/octocat/Hello-World/statuses/{sha}",
                                                                                                                "subscribers_url": "http://api.github.com/repos/octocat/Hello-World/subscribers",
                                                                                                                "subscription_url": "http://api.github.com/repos/octocat/Hello-World/subscription",
                                                                                                                "svn_url": "https://svn.github.com/octocat/Hello-World",
                                                                                                                "tags_url": "http://api.github.com/repos/octocat/Hello-World/tags",
                                                                                                                "teams_url": "http://api.github.com/repos/octocat/Hello-World/teams",
                                                                                                                "trees_url": "http://api.github.com/repos/octocat/Hello-World/git/trees{/sha}",
                                                                                                                "homepage": "https://github.com",
                                                                                                                "language": null,
                                                                                                                "forks_count": 9,
                                                                                                                "stargazers_count": 80,
                                                                                                                "watchers_count": 80,
                                                                                                                "size": 108,
                                                                                                                "default_branch": "master",
                                                                                                                "open_issues_count": 0,
                                                                                                                "topics": [
                                                                                                                  "octocat",
                                                                                                                  "atom",
                                                                                                                  "electron",
                                                                                                                  "API"
                                                                                                                ],
                                                                                                                "has_issues": true,
                                                                                                                "has_wiki": true,
                                                                                                                "has_pages": false,
                                                                                                                "has_downloads": true,
                                                                                                                "archived": false,
                                                                                                                "pushed_at": "2011-01-26T19:06:43Z",
                                                                                                                "created_at": "2011-01-26T19:01:12Z",
                                                                                                                "updated_at": "2011-01-26T19:14:43Z",
                                                                                                                "permissions": {
                                                                                                                  "admin": false,
                                                                                                                  "push": false,
                                                                                                                  "pull": true
                                                                                                                },
                                                                                                                "allow_rebase_merge": true,
                                                                                                                "allow_squash_merge": true,
                                                                                                                "allow_merge_commit": true,
                                                                                                                "subscribers_count": 42,
                                                                                                                "network_count": 0
                                                                                                              }
                                                                                                            ]
                                                                                                          }
                                                                                                          

                                                                                                          Get a list of migrations

                                                                                                          Lists the most recent migrations.

                                                                                                          GET /orgs/:org/migrations
                                                                                                          

                                                                                                          Response

                                                                                                          Status: 200 OK
                                                                                                          Link: <https://api.github.com/resource?page=2>; rel="next",
                                                                                                                <https://api.github.com/resource?page=5>; rel="last"
                                                                                                          
                                                                                                          [
                                                                                                            {
                                                                                                              "id": 79,
                                                                                                              "guid": "0b989ba4-242f-11e5-81e1-c7b6966d2516",
                                                                                                              "state": "pending",
                                                                                                              "lock_repositories": true,
                                                                                                              "exclude_attachments": false,
                                                                                                              "url": "https://api.github.com/orgs/octo-org/migrations/79",
                                                                                                              "created_at": "2015-07-06T15:33:38-07:00",
                                                                                                              "updated_at": "2015-07-06T15:33:38-07:00",
                                                                                                              "repositories": [
                                                                                                                {
                                                                                                                  "id": 1296269,
                                                                                                                  "owner": {
                                                                                                                    "login": "octocat",
                                                                                                                    "id": 1,
                                                                                                                    "avatar_url": "https://github.com/images/error/octocat_happy.gif",
                                                                                                                    "gravatar_id": "",
                                                                                                                    "url": "https://api.github.com/users/octocat",
                                                                                                                    "html_url": "https://github.com/octocat",
                                                                                                                    "followers_url": "https://api.github.com/users/octocat/followers",
                                                                                                                    "following_url": "https://api.github.com/users/octocat/following{/other_user}",
                                                                                                                    "gists_url": "https://api.github.com/users/octocat/gists{/gist_id}",
                                                                                                                    "starred_url": "https://api.github.com/users/octocat/starred{/owner}{/repo}",
                                                                                                                    "subscriptions_url": "https://api.github.com/users/octocat/subscriptions",
                                                                                                                    "organizations_url": "https://api.github.com/users/octocat/orgs",
                                                                                                                    "repos_url": "https://api.github.com/users/octocat/repos",
                                                                                                                    "events_url": "https://api.github.com/users/octocat/events{/privacy}",
                                                                                                                    "received_events_url": "https://api.github.com/users/octocat/received_events",
                                                                                                                    "type": "User",
                                                                                                                    "site_admin": false
                                                                                                                  },
                                                                                                                  "name": "Hello-World",
                                                                                                                  "full_name": "octocat/Hello-World",
                                                                                                                  "description": "This your first repo!",
                                                                                                                  "private": false,
                                                                                                                  "fork": false,
                                                                                                                  "url": "https://api.github.com/repos/octocat/Hello-World",
                                                                                                                  "html_url": "https://github.com/octocat/Hello-World",
                                                                                                                  "archive_url": "http://api.github.com/repos/octocat/Hello-World/{archive_format}{/ref}",
                                                                                                                  "assignees_url": "http://api.github.com/repos/octocat/Hello-World/assignees{/user}",
                                                                                                                  "blobs_url": "http://api.github.com/repos/octocat/Hello-World/git/blobs{/sha}",
                                                                                                                  "branches_url": "http://api.github.com/repos/octocat/Hello-World/branches{/branch}",
                                                                                                                  "clone_url": "https://github.com/octocat/Hello-World.git",
                                                                                                                  "collaborators_url": "http://api.github.com/repos/octocat/Hello-World/collaborators{/collaborator}",
                                                                                                                  "comments_url": "http://api.github.com/repos/octocat/Hello-World/comments{/number}",
                                                                                                                  "commits_url": "http://api.github.com/repos/octocat/Hello-World/commits{/sha}",
                                                                                                                  "compare_url": "http://api.github.com/repos/octocat/Hello-World/compare/{base}...{head}",
                                                                                                                  "contents_url": "http://api.github.com/repos/octocat/Hello-World/contents/{+path}",
                                                                                                                  "contributors_url": "http://api.github.com/repos/octocat/Hello-World/contributors",
                                                                                                                  "deployments_url": "http://api.github.com/repos/octocat/Hello-World/deployments",
                                                                                                                  "downloads_url": "http://api.github.com/repos/octocat/Hello-World/downloads",
                                                                                                                  "events_url": "http://api.github.com/repos/octocat/Hello-World/events",
                                                                                                                  "forks_url": "http://api.github.com/repos/octocat/Hello-World/forks",
                                                                                                                  "git_commits_url": "http://api.github.com/repos/octocat/Hello-World/git/commits{/sha}",
                                                                                                                  "git_refs_url": "http://api.github.com/repos/octocat/Hello-World/git/refs{/sha}",
                                                                                                                  "git_tags_url": "http://api.github.com/repos/octocat/Hello-World/git/tags{/sha}",
                                                                                                                  "git_url": "git:github.com/octocat/Hello-World.git",
                                                                                                                  "hooks_url": "http://api.github.com/repos/octocat/Hello-World/hooks",
                                                                                                                  "issue_comment_url": "http://api.github.com/repos/octocat/Hello-World/issues/comments{/number}",
                                                                                                                  "issue_events_url": "http://api.github.com/repos/octocat/Hello-World/issues/events{/number}",
                                                                                                                  "issues_url": "http://api.github.com/repos/octocat/Hello-World/issues{/number}",
                                                                                                                  "keys_url": "http://api.github.com/repos/octocat/Hello-World/keys{/key_id}",
                                                                                                                  "labels_url": "http://api.github.com/repos/octocat/Hello-World/labels{/name}",
                                                                                                                  "languages_url": "http://api.github.com/repos/octocat/Hello-World/languages",
                                                                                                                  "merges_url": "http://api.github.com/repos/octocat/Hello-World/merges",
                                                                                                                  "milestones_url": "http://api.github.com/repos/octocat/Hello-World/milestones{/number}",
                                                                                                                  "mirror_url": "git:git.example.com/octocat/Hello-World",
                                                                                                                  "notifications_url": "http://api.github.com/repos/octocat/Hello-World/notifications{?since,all,participating}",
                                                                                                                  "pulls_url": "http://api.github.com/repos/octocat/Hello-World/pulls{/number}",
                                                                                                                  "releases_url": "http://api.github.com/repos/octocat/Hello-World/releases{/id}",
                                                                                                                  "ssh_url": "git@github.com:octocat/Hello-World.git",
                                                                                                                  "stargazers_url": "http://api.github.com/repos/octocat/Hello-World/stargazers",
                                                                                                                  "statuses_url": "http://api.github.com/repos/octocat/Hello-World/statuses/{sha}",
                                                                                                                  "subscribers_url": "http://api.github.com/repos/octocat/Hello-World/subscribers",
                                                                                                                  "subscription_url": "http://api.github.com/repos/octocat/Hello-World/subscription",
                                                                                                                  "svn_url": "https://svn.github.com/octocat/Hello-World",
                                                                                                                  "tags_url": "http://api.github.com/repos/octocat/Hello-World/tags",
                                                                                                                  "teams_url": "http://api.github.com/repos/octocat/Hello-World/teams",
                                                                                                                  "trees_url": "http://api.github.com/repos/octocat/Hello-World/git/trees{/sha}",
                                                                                                                  "homepage": "https://github.com",
                                                                                                                  "language": null,
                                                                                                                  "forks_count": 9,
                                                                                                                  "stargazers_count": 80,
                                                                                                                  "watchers_count": 80,
                                                                                                                  "size": 108,
                                                                                                                  "default_branch": "master",
                                                                                                                  "open_issues_count": 0,
                                                                                                                  "topics": [
                                                                                                                    "octocat",
                                                                                                                    "atom",
                                                                                                                    "electron",
                                                                                                                    "API"
                                                                                                                  ],
                                                                                                                  "has_issues": true,
                                                                                                                  "has_wiki": true,
                                                                                                                  "has_pages": false,
                                                                                                                  "has_downloads": true,
                                                                                                                  "archived": false,
                                                                                                                  "pushed_at": "2011-01-26T19:06:43Z",
                                                                                                                  "created_at": "2011-01-26T19:01:12Z",
                                                                                                                  "updated_at": "2011-01-26T19:14:43Z",
                                                                                                                  "permissions": {
                                                                                                                    "admin": false,
                                                                                                                    "push": false,
                                                                                                                    "pull": true
                                                                                                                  },
                                                                                                                  "allow_rebase_merge": true,
                                                                                                                  "allow_squash_merge": true,
                                                                                                                  "allow_merge_commit": true,
                                                                                                                  "subscribers_count": 42,
                                                                                                                  "network_count": 0
                                                                                                                }
                                                                                                              ]
                                                                                                            }
                                                                                                          ]
                                                                                                          

                                                                                                          Get the status of a migration

                                                                                                          Fetches the status of a migration.

                                                                                                          GET /orgs/:org/migrations/:id
                                                                                                          

                                                                                                          Response

                                                                                                          The state of a migration can be one of the following values:

                                                                                                          • pending, which means the migration hasn't started yet.
                                                                                                          • exporting, which means the migration is in progress.
                                                                                                          • exported, which means the migration finished successfully.
                                                                                                          • failed, which means the migration failed.
                                                                                                          Status: 200 OK
                                                                                                          
                                                                                                          {
                                                                                                            "id": 79,
                                                                                                            "guid": "0b989ba4-242f-11e5-81e1-c7b6966d2516",
                                                                                                            "state": "exported",
                                                                                                            "lock_repositories": true,
                                                                                                            "exclude_attachments": false,
                                                                                                            "url": "https://api.github.com/orgs/octo-org/migrations/79",
                                                                                                            "created_at": "2015-07-06T15:33:38-07:00",
                                                                                                            "updated_at": "2015-07-06T15:33:38-07:00",
                                                                                                            "repositories": [
                                                                                                              {
                                                                                                                "id": 1296269,
                                                                                                                "owner": {
                                                                                                                  "login": "octocat",
                                                                                                                  "id": 1,
                                                                                                                  "avatar_url": "https://github.com/images/error/octocat_happy.gif",
                                                                                                                  "gravatar_id": "",
                                                                                                                  "url": "https://api.github.com/users/octocat",
                                                                                                                  "html_url": "https://github.com/octocat",
                                                                                                                  "followers_url": "https://api.github.com/users/octocat/followers",
                                                                                                                  "following_url": "https://api.github.com/users/octocat/following{/other_user}",
                                                                                                                  "gists_url": "https://api.github.com/users/octocat/gists{/gist_id}",
                                                                                                                  "starred_url": "https://api.github.com/users/octocat/starred{/owner}{/repo}",
                                                                                                                  "subscriptions_url": "https://api.github.com/users/octocat/subscriptions",
                                                                                                                  "organizations_url": "https://api.github.com/users/octocat/orgs",
                                                                                                                  "repos_url": "https://api.github.com/users/octocat/repos",
                                                                                                                  "events_url": "https://api.github.com/users/octocat/events{/privacy}",
                                                                                                                  "received_events_url": "https://api.github.com/users/octocat/received_events",
                                                                                                                  "type": "User",
                                                                                                                  "site_admin": false
                                                                                                                },
                                                                                                                "name": "Hello-World",
                                                                                                                "full_name": "octocat/Hello-World",
                                                                                                                "description": "This your first repo!",
                                                                                                                "private": false,
                                                                                                                "fork": false,
                                                                                                                "url": "https://api.github.com/repos/octocat/Hello-World",
                                                                                                                "html_url": "https://github.com/octocat/Hello-World",
                                                                                                                "archive_url": "http://api.github.com/repos/octocat/Hello-World/{archive_format}{/ref}",
                                                                                                                "assignees_url": "http://api.github.com/repos/octocat/Hello-World/assignees{/user}",
                                                                                                                "blobs_url": "http://api.github.com/repos/octocat/Hello-World/git/blobs{/sha}",
                                                                                                                "branches_url": "http://api.github.com/repos/octocat/Hello-World/branches{/branch}",
                                                                                                                "clone_url": "https://github.com/octocat/Hello-World.git",
                                                                                                                "collaborators_url": "http://api.github.com/repos/octocat/Hello-World/collaborators{/collaborator}",
                                                                                                                "comments_url": "http://api.github.com/repos/octocat/Hello-World/comments{/number}",
                                                                                                                "commits_url": "http://api.github.com/repos/octocat/Hello-World/commits{/sha}",
                                                                                                                "compare_url": "http://api.github.com/repos/octocat/Hello-World/compare/{base}...{head}",
                                                                                                                "contents_url": "http://api.github.com/repos/octocat/Hello-World/contents/{+path}",
                                                                                                                "contributors_url": "http://api.github.com/repos/octocat/Hello-World/contributors",
                                                                                                                "deployments_url": "http://api.github.com/repos/octocat/Hello-World/deployments",
                                                                                                                "downloads_url": "http://api.github.com/repos/octocat/Hello-World/downloads",
                                                                                                                "events_url": "http://api.github.com/repos/octocat/Hello-World/events",
                                                                                                                "forks_url": "http://api.github.com/repos/octocat/Hello-World/forks",
                                                                                                                "git_commits_url": "http://api.github.com/repos/octocat/Hello-World/git/commits{/sha}",
                                                                                                                "git_refs_url": "http://api.github.com/repos/octocat/Hello-World/git/refs{/sha}",
                                                                                                                "git_tags_url": "http://api.github.com/repos/octocat/Hello-World/git/tags{/sha}",
                                                                                                                "git_url": "git:github.com/octocat/Hello-World.git",
                                                                                                                "hooks_url": "http://api.github.com/repos/octocat/Hello-World/hooks",
                                                                                                                "issue_comment_url": "http://api.github.com/repos/octocat/Hello-World/issues/comments{/number}",
                                                                                                                "issue_events_url": "http://api.github.com/repos/octocat/Hello-World/issues/events{/number}",
                                                                                                                "issues_url": "http://api.github.com/repos/octocat/Hello-World/issues{/number}",
                                                                                                                "keys_url": "http://api.github.com/repos/octocat/Hello-World/keys{/key_id}",
                                                                                                                "labels_url": "http://api.github.com/repos/octocat/Hello-World/labels{/name}",
                                                                                                                "languages_url": "http://api.github.com/repos/octocat/Hello-World/languages",
                                                                                                                "merges_url": "http://api.github.com/repos/octocat/Hello-World/merges",
                                                                                                                "milestones_url": "http://api.github.com/repos/octocat/Hello-World/milestones{/number}",
                                                                                                                "mirror_url": "git:git.example.com/octocat/Hello-World",
                                                                                                                "notifications_url": "http://api.github.com/repos/octocat/Hello-World/notifications{?since,all,participating}",
                                                                                                                "pulls_url": "http://api.github.com/repos/octocat/Hello-World/pulls{/number}",
                                                                                                                "releases_url": "http://api.github.com/repos/octocat/Hello-World/releases{/id}",
                                                                                                                "ssh_url": "git@github.com:octocat/Hello-World.git",
                                                                                                                "stargazers_url": "http://api.github.com/repos/octocat/Hello-World/stargazers",
                                                                                                                "statuses_url": "http://api.github.com/repos/octocat/Hello-World/statuses/{sha}",
                                                                                                                "subscribers_url": "http://api.github.com/repos/octocat/Hello-World/subscribers",
                                                                                                                "subscription_url": "http://api.github.com/repos/octocat/Hello-World/subscription",
                                                                                                                "svn_url": "https://svn.github.com/octocat/Hello-World",
                                                                                                                "tags_url": "http://api.github.com/repos/octocat/Hello-World/tags",
                                                                                                                "teams_url": "http://api.github.com/repos/octocat/Hello-World/teams",
                                                                                                                "trees_url": "http://api.github.com/repos/octocat/Hello-World/git/trees{/sha}",
                                                                                                                "homepage": "https://github.com",
                                                                                                                "language": null,
                                                                                                                "forks_count": 9,
                                                                                                                "stargazers_count": 80,
                                                                                                                "watchers_count": 80,
                                                                                                                "size": 108,
                                                                                                                "default_branch": "master",
                                                                                                                "open_issues_count": 0,
                                                                                                                "topics": [
                                                                                                                  "octocat",
                                                                                                                  "atom",
                                                                                                                  "electron",
                                                                                                                  "API"
                                                                                                                ],
                                                                                                                "has_issues": true,
                                                                                                                "has_wiki": true,
                                                                                                                "has_pages": false,
                                                                                                                "has_downloads": true,
                                                                                                                "archived": false,
                                                                                                                "pushed_at": "2011-01-26T19:06:43Z",
                                                                                                                "created_at": "2011-01-26T19:01:12Z",
                                                                                                                "updated_at": "2011-01-26T19:14:43Z",
                                                                                                                "permissions": {
                                                                                                                  "admin": false,
                                                                                                                  "push": false,
                                                                                                                  "pull": true
                                                                                                                },
                                                                                                                "allow_rebase_merge": true,
                                                                                                                "allow_squash_merge": true,
                                                                                                                "allow_merge_commit": true,
                                                                                                                "subscribers_count": 42,
                                                                                                                "network_count": 0
                                                                                                              }
                                                                                                            ]
                                                                                                          }
                                                                                                          

                                                                                                          Download a migration archive

                                                                                                          Fetches the URL to a migration archive.

                                                                                                          GET /orgs/:org/migrations/:id/archive
                                                                                                          

                                                                                                          Response

                                                                                                          Status: 302 Found
                                                                                                          
                                                                                                          
                                                                                                          https://s3.amazonaws.com/github-cloud/migration/79/67?response-content-disposition=filename%3D0b989ba4-242f-11e5-81e1.tar.gz&response-content-type=application/x-gzip
                                                                                                          

                                                                                                          Delete a migration archive

                                                                                                          Deletes a previous migration archive. Migration archives are automatically deleted after seven days.

                                                                                                          DELETE /orgs/:org/migrations/:id/archive
                                                                                                          

                                                                                                          Response

                                                                                                          Status: 204 No Content
                                                                                                          

                                                                                                          Unlock a repository

                                                                                                          Unlocks a repository that was locked for migration. You should unlock each migrated repository and delete them when the migration is complete and you no longer need the source data.

                                                                                                          DELETE /orgs/:org/migrations/:id/repos/:repo_name/lock
                                                                                                          

                                                                                                          Response

                                                                                                          Status: 204 No Content
                                                                                                          
                                                                                                          tmp/developer.github.com/v3/migration/source_imports/index.html Source Imports | GitHub API | GitHub Developer Guide

                                                                                                          Source Imports

                                                                                                          The source import APIs are currently in public preview. During this period, the APIs may change in a backwards-incompatible way. To access the API during the preview period, you must provide a custom media type in the Accept header:

                                                                                                            application/vnd.github.barred-rock-preview
                                                                                                          

                                                                                                          The Source Import API lets you start an import from a Git, Subversion, Mercurial, or Team Foundation Server source repository. This is the same functionality as the GitHub Importer.

                                                                                                          A typical source import would start the import and then (optionally) update the authors and/or set the preference for using Git LFS if large files exist in the import. A more detailed example can be seen in this diagram:

                                                                                                          +---------+                     +--------+                              +---------------------+
                                                                                                          | Tooling |                     | GitHub |                              | Original Repository |
                                                                                                          +---------+                     +--------+                              +---------------------+
                                                                                                               |                              |                                              |
                                                                                                               |  Start import                |                                              |
                                                                                                               |----------------------------->|                                              |
                                                                                                               |                              |                                              |
                                                                                                               |                              |  Download source data                        |
                                                                                                               |                              |--------------------------------------------->|
                                                                                                               |                              |                        Begin streaming data  |
                                                                                                               |                              |<---------------------------------------------|
                                                                                                               |                              |                                              |
                                                                                                               |  Get import progress         |                                              |
                                                                                                               |----------------------------->|                                              |
                                                                                                               |       "status": "importing"  |                                              |
                                                                                                               |<-----------------------------|                                              |
                                                                                                               |                              |                                              |
                                                                                                               |  Get commit authors          |                                              |
                                                                                                               |----------------------------->|                                              |
                                                                                                               |                              |                                              |
                                                                                                               |  Map a commit author         |                                              |
                                                                                                               |----------------------------->|                                              |
                                                                                                               |                              |                                              |
                                                                                                               |                              |                                              |
                                                                                                               |                              |                       Finish streaming data  |
                                                                                                               |                              |<---------------------------------------------|
                                                                                                               |                              |                                              |
                                                                                                               |                              |  Rewrite commits with mapped authors         |
                                                                                                               |                              |------+                                       |
                                                                                                               |                              |      |                                       |
                                                                                                               |                              |<-----+                                       |
                                                                                                               |                              |                                              |
                                                                                                               |                              |  Update repository on GitHub                 |
                                                                                                               |                              |------+                                       |
                                                                                                               |                              |      |                                       |
                                                                                                               |                              |<-----+                                       |
                                                                                                               |                              |                                              |
                                                                                                               |  Map a commit author         |                                              |
                                                                                                               |----------------------------->|                                              |
                                                                                                               |                              |  Rewrite commits with mapped authors         |
                                                                                                               |                              |------+                                       |
                                                                                                               |                              |      |                                       |
                                                                                                               |                              |<-----+                                       |
                                                                                                               |                              |                                              |
                                                                                                               |                              |  Update repository on GitHub                 |
                                                                                                               |                              |------+                                       |
                                                                                                               |                              |      |                                       |
                                                                                                               |                              |<-----+                                       |
                                                                                                               |                              |                                              |
                                                                                                               |  Get large files             |                                              |
                                                                                                               |----------------------------->|                                              |
                                                                                                               |                              |                                              |
                                                                                                               |  opt_in to Git LFS           |                                              |
                                                                                                               |----------------------------->|                                              |
                                                                                                               |                              |  Rewrite commits for large files             |
                                                                                                               |                              |------+                                       |
                                                                                                               |                              |      |                                       |
                                                                                                               |                              |<-----+                                       |
                                                                                                               |                              |                                              |
                                                                                                               |                              |  Update repository on GitHub                 |
                                                                                                               |                              |------+                                       |
                                                                                                               |                              |      |                                       |
                                                                                                               |                              |<-----+                                       |
                                                                                                               |                              |                                              |
                                                                                                               |  Get import progress         |                                              |
                                                                                                               |----------------------------->|                                              |
                                                                                                               |        "status": "complete"  |                                              |
                                                                                                               |<-----------------------------|                                              |
                                                                                                               |                              |                                              |
                                                                                                               |                              |                                              |
                                                                                                          

                                                                                                          Start an import

                                                                                                          Start a source import to a GitHub repository using GitHub Importer.

                                                                                                          PUT /repos/:owner/:repo/import
                                                                                                          

                                                                                                          Parameters

                                                                                                          Name Type Description
                                                                                                          vcs_url url Required The URL of the originating repository.
                                                                                                          vcs string The originating VCS type. Can be one of subversion, git, mercurial, or tfvc. Please be aware that without this parameter, the import job will take additional time to detect the VCS type before beginning the import. This detection step will be reflected in the response.
                                                                                                          vcs_username string If authentication is required, the username to provide to vcs_url.
                                                                                                          vcs_password string If authentication is required, the password to provide to vcs_url.
                                                                                                          tfvc_project string For a tfvc import, the name of the project that is being imported.

                                                                                                          Example

                                                                                                          {
                                                                                                            "vcs": "subversion",
                                                                                                            "vcs_url": "http://svn.mycompany.com/svn/myproject",
                                                                                                            "vcs_username": "octocat",
                                                                                                            "vcs_password": "secret"
                                                                                                          }
                                                                                                          

                                                                                                          Response

                                                                                                          Status: 201 Created
                                                                                                          Location: https://api.github.com/repos/spraints/socm/import
                                                                                                          
                                                                                                          {
                                                                                                            "vcs": "subversion",
                                                                                                            "use_lfs": "undecided",
                                                                                                            "vcs_url": "http://svn.mycompany.com/svn/myproject",
                                                                                                            "status": "importing",
                                                                                                            "status_text": "Importing...",
                                                                                                            "has_large_files": false,
                                                                                                            "large_files_size": 0,
                                                                                                            "large_files_count": 0,
                                                                                                            "authors_count": 0,
                                                                                                            "percent": 42,
                                                                                                            "commit_count": 1042,
                                                                                                            "url": "https://api.github.com/repos/octocat/socm/import",
                                                                                                            "html_url": "https://import.github.com/octocat/socm/import",
                                                                                                            "authors_url": "https://api.github.com/repos/octocat/socm/import/authors",
                                                                                                            "repository_url": "https://api.github.com/repos/octocat/socm"
                                                                                                          }
                                                                                                          

                                                                                                          Get import progress

                                                                                                          View the progress of an import.

                                                                                                          GET /repos/:owner/:repo/import
                                                                                                          

                                                                                                          Response

                                                                                                          Status: 200 OK
                                                                                                          
                                                                                                          {
                                                                                                            "vcs": "subversion",
                                                                                                            "use_lfs": "opt_in",
                                                                                                            "vcs_url": "http://svn.mycompany.com/svn/myproject",
                                                                                                            "status": "complete",
                                                                                                            "status_text": "Done",
                                                                                                            "has_large_files": true,
                                                                                                            "large_files_size": 132331036,
                                                                                                            "large_files_count": 1,
                                                                                                            "authors_count": 4,
                                                                                                            "url": "https://api.github.com/repos/octocat/socm/import",
                                                                                                            "html_url": "https://import.github.com/octocat/socm/import",
                                                                                                            "authors_url": "https://api.github.com/repos/octocat/socm/import/authors",
                                                                                                            "repository_url": "https://api.github.com/repos/octocat/socm"
                                                                                                          }
                                                                                                          

                                                                                                          Import status

                                                                                                          This section includes details about the possible values of the status field of the Import Progress response.

                                                                                                          An import that does not have errors will progress through these steps:

                                                                                                          • detecting - the "detection" step of the import is in progress because the request did not include a vcs parameter. The import is identifying the type of source control present at the URL.
                                                                                                          • importing - the "raw" step of the import is in progress. This is where commit data is fetched from the original repository. The import progress response will include commit_count (the total number of raw commits that will be imported) and percent (0 - 100, the current progress through the import).
                                                                                                          • mapping - the "rewrite" step of the import is in progress. This is where SVN branches are converted to Git branches, and where author updates are applied. The import progress response does not include progress information.
                                                                                                          • pushing - the "push" step of the import is in progress. This is where the importer updates the repository on GitHub. The import progress response will include push_percent, which is the percent value reported by git push when it is "Writing objects".
                                                                                                          • complete - the import is complete, and the repository is ready on GitHub.

                                                                                                          If there are problems, you will see one of these in the status field:

                                                                                                          • auth_failed - the import requires authentication in order to connect to the original repository. To update authentication for the import, please see the Update Existing Import section.
                                                                                                          • error - the import encountered an error. The import progress response will include the failed_step and an error message. Contact GitHub support for more information.
                                                                                                          • detection_needs_auth - the importer requires authentication for the originating repository to continue detection. To update authentication for the import, please see the Update Existing Import section.
                                                                                                          • detection_found_nothing - the importer didn't recognize any source control at the URL. To resolve, Cancel the import and retry with the correct URL.
                                                                                                          • detection_found_multiple - the importer found several projects or repositories at the provided URL. When this is the case, the Import Progress response will also include a project_choices field with the possible project choices as values. To update project choice, please see the Update Existing Import section.

                                                                                                          The project_choices field

                                                                                                          When multiple projects are found at the provided URL, the response hash will include a project_choices field, the value of which is an array of hashes each representing a project choice. The exact key/value pairs of the project hashes will differ depending on the version control type.

                                                                                                          [
                                                                                                            {
                                                                                                              "vcs": "tfvc",
                                                                                                              "tfvc_project": "project0",
                                                                                                              "human_name": "project0 (tfs)"
                                                                                                            },
                                                                                                            {
                                                                                                              "vcs": "tfvc",
                                                                                                              "tfvc_project": "project1",
                                                                                                              "human_name": "project1 (tfs)"
                                                                                                            },
                                                                                                            {
                                                                                                              "vcs": "tfvc",
                                                                                                              "tfvc_project": "project2",
                                                                                                              "human_name": "project2 (tfs)"
                                                                                                            },
                                                                                                            {
                                                                                                              "vcs": "tfvc",
                                                                                                              "tfvc_project": "project3",
                                                                                                              "human_name": "project3 (tfs)"
                                                                                                            }
                                                                                                          ]
                                                                                                          

                                                                                                          Git LFS related fields

                                                                                                          This section includes details about Git LFS related fields that may be present in the Import Progress response.

                                                                                                          • use_lfs - describes whether the import has been opted in or out of using Git LFS. The value can be opt_in, opt_out, or undecided if no action has been taken.
                                                                                                          • has_large_files - the boolean value describing whether files larger than 100MB were found during the importing step.
                                                                                                          • large_files_size - the total size in gigabytes of files larger than 100MB found in the originating repository.
                                                                                                          • large_files_count - the total number of files larger than 100MB found in the originating repository. To see a list of these files, make a "Get Large Files" request.

                                                                                                          Update existing import

                                                                                                          An import can be updated with credentials or a project choice by passing in the appropriate parameters in this API request. If no parameters are provided, the import will be restarted.

                                                                                                          PATCH /repos/:owner/:repo/import
                                                                                                          

                                                                                                          Parameters for updating authentication

                                                                                                          Name Type Description
                                                                                                          vcs_username string The username to provide to the originating repository.
                                                                                                          vcs_password string The password to provide to the originating repository.

                                                                                                          Example

                                                                                                          {
                                                                                                            "vcs_username": "octocat",
                                                                                                            "vcs_password": "secret"
                                                                                                          }
                                                                                                          

                                                                                                          Response

                                                                                                          Status: 200 OK
                                                                                                          
                                                                                                          {
                                                                                                            "vcs": "subversion",
                                                                                                            "use_lfs": "undecided",
                                                                                                            "vcs_url": "http://svn.mycompany.com/svn/myproject",
                                                                                                            "status": "detecting",
                                                                                                            "url": "https://api.github.com/repos/octocat/socm/import",
                                                                                                            "html_url": "https://import.github.com/octocat/socm/import",
                                                                                                            "authors_url": "https://api.github.com/repos/octocat/socm/import/authors",
                                                                                                            "repository_url": "https://api.github.com/repos/octocat/socm"
                                                                                                          }
                                                                                                          

                                                                                                          Parameters for updating project choice

                                                                                                          Some servers (e.g. TFS servers) can have several projects at a single URL. In those cases the import progress will have the status detection_found_multiple and the Import Progress response will include a project_choices array. You can select the project to import by providing one of the objects in the project_choices array in the update request.

                                                                                                          The following example demonstrates the workflow for updating an import with "project1" as the project choice. Given a project_choices array like such:

                                                                                                          [
                                                                                                            {
                                                                                                              "vcs": "tfvc",
                                                                                                              "tfvc_project": "project0",
                                                                                                              "human_name": "project0 (tfs)"
                                                                                                            },
                                                                                                            {
                                                                                                              "vcs": "tfvc",
                                                                                                              "tfvc_project": "project1",
                                                                                                              "human_name": "project1 (tfs)"
                                                                                                            },
                                                                                                            {
                                                                                                              "vcs": "tfvc",
                                                                                                              "tfvc_project": "project2",
                                                                                                              "human_name": "project2 (tfs)"
                                                                                                            },
                                                                                                            {
                                                                                                              "vcs": "tfvc",
                                                                                                              "tfvc_project": "project3",
                                                                                                              "human_name": "project3 (tfs)"
                                                                                                            }
                                                                                                          ]
                                                                                                          

                                                                                                          Example

                                                                                                          {
                                                                                                            "vcs": "tfvc",
                                                                                                            "tfvc_project": "project1",
                                                                                                            "human_name": "project1 (tfs)"
                                                                                                          }
                                                                                                          

                                                                                                          Response

                                                                                                          Status: 200 OK
                                                                                                          
                                                                                                          {
                                                                                                            "vcs": "tfvc",
                                                                                                            "use_lfs": "undecided",
                                                                                                            "vcs_url": "http://tfs.mycompany.com/tfs/myproject",
                                                                                                            "tfvc_project": "project1",
                                                                                                            "status": "importing",
                                                                                                            "status_text": "Importing...",
                                                                                                            "has_large_files": false,
                                                                                                            "large_files_size": 0,
                                                                                                            "large_files_count": 0,
                                                                                                            "authors_count": 0,
                                                                                                            "percent": 42,
                                                                                                            "commit_count": 1042,
                                                                                                            "url": "https://api.github.com/repos/octocat/socm/import",
                                                                                                            "html_url": "https://import.github.com/octocat/socm/import",
                                                                                                            "authors_url": "https://api.github.com/repos/octocat/socm/import/authors",
                                                                                                            "repository_url": "https://api.github.com/repos/octocat/socm"
                                                                                                          }
                                                                                                          

                                                                                                          Parameters for restarting import

                                                                                                          To restart an import, no parameters are provided in the update request.

                                                                                                          Response

                                                                                                          Status: 200 OK
                                                                                                          Location: https://api.github.com/repos/spraints/socm/import
                                                                                                          
                                                                                                          {
                                                                                                            "vcs": "subversion",
                                                                                                            "use_lfs": "undecided",
                                                                                                            "vcs_url": "http://svn.mycompany.com/svn/myproject",
                                                                                                            "status": "importing",
                                                                                                            "status_text": "Importing...",
                                                                                                            "has_large_files": false,
                                                                                                            "large_files_size": 0,
                                                                                                            "large_files_count": 0,
                                                                                                            "authors_count": 0,
                                                                                                            "percent": 42,
                                                                                                            "commit_count": 1042,
                                                                                                            "url": "https://api.github.com/repos/octocat/socm/import",
                                                                                                            "html_url": "https://import.github.com/octocat/socm/import",
                                                                                                            "authors_url": "https://api.github.com/repos/octocat/socm/import/authors",
                                                                                                            "repository_url": "https://api.github.com/repos/octocat/socm"
                                                                                                          }
                                                                                                          

                                                                                                          Get commit authors

                                                                                                          Each type of source control system represents authors in a different way. For example, a Git commit author has a display name and an email address, but a Subversion commit author just has a username. The GitHub Importer will make the author information valid, but the author might not be correct. For example, it will change the bare Subversion username hubot into something like hubot <hubot@12341234-abab-fefe-8787-fedcba987654>.

                                                                                                          This API method and the "Map a commit author" method allow you to provide correct Git author information.

                                                                                                          GET /repos/:owner/:repo/import/authors
                                                                                                          

                                                                                                          Parameters

                                                                                                          Name Type Description
                                                                                                          since string Only authors found after this id are returned. Provide the highest author ID you've seen so far. New authors may be added to the list at any point while the importer is performing the raw step.

                                                                                                          Response

                                                                                                          Status: 200 OK
                                                                                                          
                                                                                                          [
                                                                                                            {
                                                                                                              "id": 2268557,
                                                                                                              "remote_id": "nobody@fc7da526-431c-80fe-3c8c-c148ff18d7ef",
                                                                                                              "remote_name": "nobody",
                                                                                                              "email": "hubot@github.com",
                                                                                                              "name": "Hubot",
                                                                                                              "url": "https://api.github.com/repos/octocat/socm/import/authors/2268557",
                                                                                                              "import_url": "https://api.github.com/repos/octocat/socm/import"
                                                                                                            },
                                                                                                            {
                                                                                                              "id": 2268558,
                                                                                                              "remote_id": "svner@fc7da526-431c-80fe-3c8c-c148ff18d7ef",
                                                                                                              "remote_name": "svner",
                                                                                                              "email": "svner@fc7da526-431c-80fe-3c8c-c148ff18d7ef",
                                                                                                              "name": "svner",
                                                                                                              "url": "https://api.github.com/repos/octocat/socm/import/authors/2268558",
                                                                                                              "import_url": "https://api.github.com/repos/octocat/socm/import"
                                                                                                            },
                                                                                                            {
                                                                                                              "id": 2268559,
                                                                                                              "remote_id": "svner@example.com@fc7da526-431c-80fe-3c8c-c148ff18d7ef",
                                                                                                              "remote_name": "svner@example.com",
                                                                                                              "email": "svner@example.com@fc7da526-431c-80fe-3c8c-c148ff18d7ef",
                                                                                                              "name": "svner@example.com",
                                                                                                              "url": "https://api.github.com/repos/octocat/socm/import/authors/2268559",
                                                                                                              "import_url": "https://api.github.com/repos/octocat/socm/import"
                                                                                                            }
                                                                                                          ]
                                                                                                          

                                                                                                          Map a commit author

                                                                                                          Update an author's identity for the import. Your application can continue updating authors any time before you push new commits to the repository.

                                                                                                          PATCH /repos/:owner/:repo/import/authors/:author_id
                                                                                                          

                                                                                                          Parameters

                                                                                                          Name Type Description
                                                                                                          email string The new Git author email.
                                                                                                          name string The new Git author name.

                                                                                                          Example

                                                                                                          {
                                                                                                            "email": "hubot@github.com",
                                                                                                            "name": "Hubot the Robot"
                                                                                                          }
                                                                                                          

                                                                                                          Response

                                                                                                          Status: 200 OK
                                                                                                          
                                                                                                          {
                                                                                                            "id": 2268557,
                                                                                                            "remote_id": "nobody@fc7da526-431c-80fe-3c8c-c148ff18d7ef",
                                                                                                            "remote_name": "nobody",
                                                                                                            "email": "hubot@github.com",
                                                                                                            "name": "Hubot",
                                                                                                            "url": "https://api.github.com/repos/octocat/socm/import/authors/2268557",
                                                                                                            "import_url": "https://api.github.com/repos/octocat/socm/import"
                                                                                                          }
                                                                                                          

                                                                                                          Set Git LFS preference

                                                                                                          You can import repositories from Subversion, Mercurial, and TFS that include files larger than 100MB. This ability is powered by Git LFS. You can learn more about our LFS feature and working with large files on our help site.

                                                                                                          PATCH /repos/:owner/:repo/import/lfs
                                                                                                          

                                                                                                          Parameters

                                                                                                          Name Type Description
                                                                                                          use_lfs string Required Can be one of opt_in (large files will be stored using Git LFS) or opt_out (large files will be removed during the import).

                                                                                                          Example

                                                                                                          {
                                                                                                            "use_lfs": "opt_in"
                                                                                                          }
                                                                                                          

                                                                                                          Response

                                                                                                          Status: 200 OK
                                                                                                          
                                                                                                          {
                                                                                                            "vcs": "subversion",
                                                                                                            "use_lfs": "opt_in",
                                                                                                            "vcs_url": "http://svn.mycompany.com/svn/myproject",
                                                                                                            "status": "complete",
                                                                                                            "status_text": "Done",
                                                                                                            "has_large_files": true,
                                                                                                            "large_files_size": 132331036,
                                                                                                            "large_files_count": 1,
                                                                                                            "authors_count": 4,
                                                                                                            "url": "https://api.github.com/repos/octocat/socm/import",
                                                                                                            "html_url": "https://import.github.com/octocat/socm/import",
                                                                                                            "authors_url": "https://api.github.com/repos/octocat/socm/import/authors",
                                                                                                            "repository_url": "https://api.github.com/repos/octocat/socm"
                                                                                                          }
                                                                                                          

                                                                                                          Get large files

                                                                                                          List files larger than 100MB found during the import

                                                                                                          GET /repos/:owner/:repo/import/large_files
                                                                                                          

                                                                                                          Response

                                                                                                          Status: 200 OK
                                                                                                          
                                                                                                          [
                                                                                                            {
                                                                                                              "ref_name": "refs/heads/master",
                                                                                                              "path": "foo/bar/1",
                                                                                                              "oid": "d3d9446802a44259755d38e6d163e820",
                                                                                                              "size": 10485760
                                                                                                            },
                                                                                                            {
                                                                                                              "ref_name": "refs/heads/master",
                                                                                                              "path": "foo/bar/2",
                                                                                                              "oid": "6512bd43d9caa6e02c990b0a82652dca",
                                                                                                              "size": 11534336
                                                                                                            },
                                                                                                            {
                                                                                                              "ref_name": "refs/heads/master",
                                                                                                              "path": "foo/bar/3",
                                                                                                              "oid": "c20ad4d76fe97759aa27a0c99bff6710",
                                                                                                              "size": 12582912
                                                                                                            }
                                                                                                          ]
                                                                                                          

                                                                                                          Cancel an import

                                                                                                          Stop an import for a repository.

                                                                                                          DELETE /repos/:owner/:repo/import
                                                                                                          

                                                                                                          Response

                                                                                                          Status: 204 No Content
                                                                                                          
                                                                                                          tmp/developer.github.com/v3/misc/index.html Miscellaneous | GitHub Developer Guide

                                                                                                          Miscellaneous

                                                                                                          This is a miscellaneous set of APIs which provide access to top level GitHub resources and info.

                                                                                                          Emojis

                                                                                                          The Emojis API lets you list all the emojis available to use on GitHub.

                                                                                                          Gitignore

                                                                                                          The Gitignore API gives you access to the available gitignore templates.

                                                                                                          Markdown

                                                                                                          The Markdown API lets you render Markdown documents.

                                                                                                          Meta

                                                                                                          The Meta API provides information about GitHub.com (the service).

                                                                                                          Rate Limit

                                                                                                          The Rate Limit API lets you check your current rate limit status at any time.

                                                                                                          Licenses

                                                                                                          The Licenses API returns information about open source licenses or under what license, if any a given project is distributed.

                                                                                                          Codes of Conduct

                                                                                                          The Codes of Conduct API returns information about a code of conduct or returns which code of conduct, if any a given project has.

                                                                                                          tmp/developer.github.com/v3/oauth_authorizations/index.html Authorizations | GitHub Developer Guide


                                                                                                          Deprecation Notice

                                                                                                          The token attribute is deprecated in all of the following OAuth Authorizations API responses:

                                                                                                          To reduce the impact of removing the token value, the OAuth Authorizations API now includes a new request attribute (fingerprint), three new response attributes (token_last_eight, hashed_token, and fingerprint), and one new endpoint.

                                                                                                          This functionality became the default for all requests on April 20, 2015. Please see the blog post for full details.

                                                                                                          OAuth Authorizations API

                                                                                                          You can use this API to manage the access OAuth applications have to your account. You can only access this API via Basic Authentication using your username and password, not tokens.

                                                                                                          Make sure you understand how to work with two-factor authentication if you or your users have two-factor authentication enabled.

                                                                                                          List your grants

                                                                                                          You can use this API to list the set of OAuth applications that have been granted access to your account. Unlike the list your authorizations API, this API does not manage individual tokens. This API will return one entry for each OAuth application that has been granted access to your account, regardless of the number of tokens an application has generated for your user. The list of OAuth applications returned matches what is shown on the application authorizations settings screen within GitHub. The scopes returned are the union of scopes authorized for the application. For example, if an application has one token with repo scope and another token with user scope, the grant will return ["repo", "user"].

                                                                                                          GET /applications/grants
                                                                                                          

                                                                                                          Response

                                                                                                          Status: 200 OK
                                                                                                          Link: <https://api.github.com/resource?page=2>; rel="next",
                                                                                                                <https://api.github.com/resource?page=5>; rel="last"
                                                                                                          
                                                                                                          [
                                                                                                            {
                                                                                                              "id": 1,
                                                                                                              "url": "https://api.github.com/applications/grants/1",
                                                                                                              "app": {
                                                                                                                "url": "http://my-github-app.com",
                                                                                                                "name": "my github app",
                                                                                                                "client_id": "abcde12345fghij67890"
                                                                                                              },
                                                                                                              "created_at": "2011-09-06T17:26:27Z",
                                                                                                              "updated_at": "2011-09-06T20:39:23Z",
                                                                                                              "scopes": [
                                                                                                                "public_repo"
                                                                                                              ]
                                                                                                            }
                                                                                                          ]
                                                                                                          

                                                                                                          Get a single grant

                                                                                                          GET /applications/grants/:id
                                                                                                          

                                                                                                          Response

                                                                                                          Status: 200 OK
                                                                                                          
                                                                                                          {
                                                                                                            "id": 1,
                                                                                                            "url": "https://api.github.com/applications/grants/1",
                                                                                                            "app": {
                                                                                                              "url": "http://my-github-app.com",
                                                                                                              "name": "my github app",
                                                                                                              "client_id": "abcde12345fghij67890"
                                                                                                            },
                                                                                                            "created_at": "2011-09-06T17:26:27Z",
                                                                                                            "updated_at": "2011-09-06T20:39:23Z",
                                                                                                            "scopes": [
                                                                                                              "public_repo"
                                                                                                            ]
                                                                                                          }
                                                                                                          

                                                                                                          Delete a grant

                                                                                                          Deleting an OAuth application's grant will also delete all OAuth tokens associated with the application for your user. Once deleted, the application has no access to your account and is no longer listed on the application authorizations settings screen within GitHub.

                                                                                                          DELETE /applications/grants/:id
                                                                                                          

                                                                                                          Response

                                                                                                          Status: 204 No Content
                                                                                                          

                                                                                                          List your authorizations

                                                                                                          GET /authorizations
                                                                                                          

                                                                                                          Response

                                                                                                          Status: 200 OK
                                                                                                          Link: <https://api.github.com/resource?page=2>; rel="next",
                                                                                                                <https://api.github.com/resource?page=5>; rel="last"
                                                                                                          
                                                                                                          [
                                                                                                            {
                                                                                                              "id": 1,
                                                                                                              "url": "https://api.github.com/authorizations/1",
                                                                                                              "scopes": [
                                                                                                                "public_repo"
                                                                                                              ],
                                                                                                              "token": "",
                                                                                                              "token_last_eight": "12345678",
                                                                                                              "hashed_token": "25f94a2a5c7fbaf499c665bc73d67c1c87e496da8985131633ee0a95819db2e8",
                                                                                                              "app": {
                                                                                                                "url": "http://my-github-app.com",
                                                                                                                "name": "my github app",
                                                                                                                "client_id": "abcde12345fghij67890"
                                                                                                              },
                                                                                                              "note": "optional note",
                                                                                                              "note_url": "http://optional/note/url",
                                                                                                              "updated_at": "2011-09-06T20:39:23Z",
                                                                                                              "created_at": "2011-09-06T17:26:27Z",
                                                                                                              "fingerprint": "jklmnop12345678"
                                                                                                            }
                                                                                                          ]
                                                                                                          

                                                                                                          Get a single authorization

                                                                                                          GET /authorizations/:id
                                                                                                          

                                                                                                          Response

                                                                                                          Status: 200 OK
                                                                                                          
                                                                                                          {
                                                                                                            "id": 1,
                                                                                                            "url": "https://api.github.com/authorizations/1",
                                                                                                            "scopes": [
                                                                                                              "public_repo"
                                                                                                            ],
                                                                                                            "token": "",
                                                                                                            "token_last_eight": "12345678",
                                                                                                            "hashed_token": "25f94a2a5c7fbaf499c665bc73d67c1c87e496da8985131633ee0a95819db2e8",
                                                                                                            "app": {
                                                                                                              "url": "http://my-github-app.com",
                                                                                                              "name": "my github app",
                                                                                                              "client_id": "abcde12345fghij67890"
                                                                                                            },
                                                                                                            "note": "optional note",
                                                                                                            "note_url": "http://optional/note/url",
                                                                                                            "updated_at": "2011-09-06T20:39:23Z",
                                                                                                            "created_at": "2011-09-06T17:26:27Z",
                                                                                                            "fingerprint": "jklmnop12345678"
                                                                                                          }
                                                                                                          

                                                                                                          Create a new authorization

                                                                                                          If you need a small number of personal access tokens, implementing the web flow can be cumbersome. Instead, tokens can be created using the OAuth Authorizations API using Basic Authentication. To create personal access tokens for a particular OAuth application, you must provide its client ID and secret, found on the OAuth application settings page, linked from your OAuth applications listing on GitHub.

                                                                                                          If your OAuth application intends to create multiple tokens for one user, use fingerprint to differentiate between them.

                                                                                                          You can also create OAuth tokens through the web UI via the personal access tokens settings. Read more about these tokens on the GitHub Help site.

                                                                                                          Organizations that enforce SAML SSO require personal access tokens to be whitelisted. Read more about whitelisting tokens on the GitHub Help site.

                                                                                                          POST /authorizations
                                                                                                          

                                                                                                          Parameters

                                                                                                          Name Type Description
                                                                                                          scopes array A list of scopes that this authorization is in.
                                                                                                          note string Required. A note to remind you what the OAuth token is for. Tokens not associated with a specific OAuth application (i.e. personal access tokens) must have a unique note.
                                                                                                          note_url string A URL to remind you what app the OAuth token is for.
                                                                                                          client_id string The 20 character OAuth app client key for which to create the token.
                                                                                                          client_secret string The 40 character OAuth app client secret for which to create the token.
                                                                                                          fingerprint string A unique string to distinguish an authorization from others created for the same client ID and user.
                                                                                                          {
                                                                                                            "scopes": [
                                                                                                              "public_repo"
                                                                                                            ],
                                                                                                            "note": "admin script"
                                                                                                          }
                                                                                                          

                                                                                                          Response

                                                                                                          Status: 201 Created
                                                                                                          Location: https://api.github.com/authorizations/1
                                                                                                          
                                                                                                          {
                                                                                                            "id": 1,
                                                                                                            "url": "https://api.github.com/authorizations/1",
                                                                                                            "scopes": [
                                                                                                              "public_repo"
                                                                                                            ],
                                                                                                            "token": "abcdefgh12345678",
                                                                                                            "token_last_eight": "12345678",
                                                                                                            "hashed_token": "25f94a2a5c7fbaf499c665bc73d67c1c87e496da8985131633ee0a95819db2e8",
                                                                                                            "app": {
                                                                                                              "url": "http://my-github-app.com",
                                                                                                              "name": "my github app",
                                                                                                              "client_id": "abcde12345fghij67890"
                                                                                                            },
                                                                                                            "note": "optional note",
                                                                                                            "note_url": "http://optional/note/url",
                                                                                                            "updated_at": "2011-09-06T20:39:23Z",
                                                                                                            "created_at": "2011-09-06T17:26:27Z",
                                                                                                            "fingerprint": ""
                                                                                                          }
                                                                                                          

                                                                                                          Get-or-create an authorization for a specific app

                                                                                                          This method will create a new authorization for the specified OAuth application, only if an authorization for that application doesn't already exist for the user. The URL includes the 20 character client ID for the OAuth app that is requesting the token. It returns the user's existing authorization for the application if one is present. Otherwise, it creates and returns a new one.

                                                                                                          PUT /authorizations/clients/:client_id
                                                                                                          

                                                                                                          Parameters

                                                                                                          Name Type Description
                                                                                                          client_secret string Required. The 40 character OAuth app client secret associated with the client ID specified in the URL.
                                                                                                          scopes array A list of scopes that this authorization is in.
                                                                                                          note string A note to remind you what the OAuth token is for.
                                                                                                          note_url string A URL to remind you what app the OAuth token is for.
                                                                                                          fingerprint string A unique string to distinguish an authorization from others created for the same client and user. If provided, this API is functionally equivalent to Get-or-create an authorization for a specific app and fingerprint.
                                                                                                          {
                                                                                                            "client_secret": "abcdabcdabcdabcdabcdabcdabcdabcdabcdabcd",
                                                                                                            "scopes": [
                                                                                                              "public_repo"
                                                                                                            ],
                                                                                                            "note": "admin script"
                                                                                                          }
                                                                                                          

                                                                                                          Response if returning a new token

                                                                                                          Status: 201 Created
                                                                                                          Location: https://api.github.com/authorizations/1
                                                                                                          
                                                                                                          {
                                                                                                            "id": 1,
                                                                                                            "url": "https://api.github.com/authorizations/1",
                                                                                                            "scopes": [
                                                                                                              "public_repo"
                                                                                                            ],
                                                                                                            "token": "abcdefgh12345678",
                                                                                                            "token_last_eight": "12345678",
                                                                                                            "hashed_token": "25f94a2a5c7fbaf499c665bc73d67c1c87e496da8985131633ee0a95819db2e8",
                                                                                                            "app": {
                                                                                                              "url": "http://my-github-app.com",
                                                                                                              "name": "my github app",
                                                                                                              "client_id": "abcde12345fghij67890"
                                                                                                            },
                                                                                                            "note": "optional note",
                                                                                                            "note_url": "http://optional/note/url",
                                                                                                            "updated_at": "2011-09-06T20:39:23Z",
                                                                                                            "created_at": "2011-09-06T17:26:27Z",
                                                                                                            "fingerprint": ""
                                                                                                          }
                                                                                                          

                                                                                                          Response if returning an existing token

                                                                                                          Status: 200 OK
                                                                                                          Location: https://api.github.com/authorizations/1
                                                                                                          
                                                                                                          {
                                                                                                            "id": 1,
                                                                                                            "url": "https://api.github.com/authorizations/1",
                                                                                                            "scopes": [
                                                                                                              "public_repo"
                                                                                                            ],
                                                                                                            "token": "",
                                                                                                            "token_last_eight": "12345678",
                                                                                                            "hashed_token": "25f94a2a5c7fbaf499c665bc73d67c1c87e496da8985131633ee0a95819db2e8",
                                                                                                            "app": {
                                                                                                              "url": "http://my-github-app.com",
                                                                                                              "name": "my github app",
                                                                                                              "client_id": "abcde12345fghij67890"
                                                                                                            },
                                                                                                            "note": "optional note",
                                                                                                            "note_url": "http://optional/note/url",
                                                                                                            "updated_at": "2011-09-06T20:39:23Z",
                                                                                                            "created_at": "2011-09-06T17:26:27Z",
                                                                                                            "fingerprint": ""
                                                                                                          }
                                                                                                          

                                                                                                          Get-or-create an authorization for a specific app and fingerprint

                                                                                                          This method will create a new authorization for the specified OAuth application, only if an authorization for that application and fingerprint do not already exist for the user. The URL includes the 20 character client ID for the OAuth app that is requesting the token. fingerprint is a unique string to distinguish an authorization from others created for the same client ID and user. It returns the user's existing authorization for the application if one is present. Otherwise, it creates and returns a new one.

                                                                                                          PUT /authorizations/clients/:client_id/:fingerprint
                                                                                                          

                                                                                                          Parameters

                                                                                                          Name Type Description
                                                                                                          client_secret string Required. The 40 character OAuth app client secret associated with the client ID specified in the URL.
                                                                                                          scopes array A list of scopes that this authorization is in.
                                                                                                          note string A note to remind you what the OAuth token is for.
                                                                                                          note_url string A URL to remind you what app the OAuth token is for.
                                                                                                          {
                                                                                                            "client_secret": "abcdabcdabcdabcdabcdabcdabcdabcdabcdabcd",
                                                                                                            "scopes": [
                                                                                                              "public_repo"
                                                                                                            ],
                                                                                                            "note": "admin script"
                                                                                                          }
                                                                                                          

                                                                                                          Response if returning a new token

                                                                                                          Status: 201 Created
                                                                                                          Location: https://api.github.com/authorizations/1
                                                                                                          
                                                                                                          {
                                                                                                            "id": 1,
                                                                                                            "url": "https://api.github.com/authorizations/1",
                                                                                                            "scopes": [
                                                                                                              "public_repo"
                                                                                                            ],
                                                                                                            "token": "abcdefgh12345678",
                                                                                                            "token_last_eight": "12345678",
                                                                                                            "hashed_token": "25f94a2a5c7fbaf499c665bc73d67c1c87e496da8985131633ee0a95819db2e8",
                                                                                                            "app": {
                                                                                                              "url": "http://my-github-app.com",
                                                                                                              "name": "my github app",
                                                                                                              "client_id": "abcde12345fghij67890"
                                                                                                            },
                                                                                                            "note": "optional note",
                                                                                                            "note_url": "http://optional/note/url",
                                                                                                            "updated_at": "2011-09-06T20:39:23Z",
                                                                                                            "created_at": "2011-09-06T17:26:27Z",
                                                                                                            "fingerprint": "jklmnop12345678"
                                                                                                          }
                                                                                                          

                                                                                                          Response if returning an existing token

                                                                                                          Status: 200 OK
                                                                                                          Location: https://api.github.com/authorizations/1
                                                                                                          
                                                                                                          {
                                                                                                            "id": 1,
                                                                                                            "url": "https://api.github.com/authorizations/1",
                                                                                                            "scopes": [
                                                                                                              "public_repo"
                                                                                                            ],
                                                                                                            "token": "",
                                                                                                            "token_last_eight": "12345678",
                                                                                                            "hashed_token": "25f94a2a5c7fbaf499c665bc73d67c1c87e496da8985131633ee0a95819db2e8",
                                                                                                            "app": {
                                                                                                              "url": "http://my-github-app.com",
                                                                                                              "name": "my github app",
                                                                                                              "client_id": "abcde12345fghij67890"
                                                                                                            },
                                                                                                            "note": "optional note",
                                                                                                            "note_url": "http://optional/note/url",
                                                                                                            "updated_at": "2011-09-06T20:39:23Z",
                                                                                                            "created_at": "2011-09-06T17:26:27Z",
                                                                                                            "fingerprint": "jklmnop12345678"
                                                                                                          }
                                                                                                          

                                                                                                          Update an existing authorization

                                                                                                          PATCH /authorizations/:id
                                                                                                          

                                                                                                          Parameters

                                                                                                          Name Type Description
                                                                                                          scopes array Replaces the authorization scopes with these.
                                                                                                          add_scopes array A list of scopes to add to this authorization.
                                                                                                          remove_scopes array A list of scopes to remove from this authorization.
                                                                                                          note string A note to remind you what the OAuth token is for. Tokens not associated with a specific OAuth application (i.e. personal access tokens) must have a unique note.
                                                                                                          note_url string A URL to remind you what app the OAuth token is for.
                                                                                                          fingerprint string A unique string to distinguish an authorization from others created for the same client ID and user.

                                                                                                          You can only send one of these scope keys at a time.

                                                                                                          {
                                                                                                            "add_scopes": [
                                                                                                              "repo"
                                                                                                            ],
                                                                                                            "note": "admin script"
                                                                                                          }
                                                                                                          

                                                                                                          Response

                                                                                                          Status: 200 OK
                                                                                                          
                                                                                                          {
                                                                                                            "id": 1,
                                                                                                            "url": "https://api.github.com/authorizations/1",
                                                                                                            "scopes": [
                                                                                                              "public_repo"
                                                                                                            ],
                                                                                                            "token": "",
                                                                                                            "token_last_eight": "12345678",
                                                                                                            "hashed_token": "25f94a2a5c7fbaf499c665bc73d67c1c87e496da8985131633ee0a95819db2e8",
                                                                                                            "app": {
                                                                                                              "url": "http://my-github-app.com",
                                                                                                              "name": "my github app",
                                                                                                              "client_id": "abcde12345fghij67890"
                                                                                                            },
                                                                                                            "note": "optional note",
                                                                                                            "note_url": "http://optional/note/url",
                                                                                                            "updated_at": "2011-09-06T20:39:23Z",
                                                                                                            "created_at": "2011-09-06T17:26:27Z",
                                                                                                            "fingerprint": "jklmnop12345678"
                                                                                                          }
                                                                                                          

                                                                                                          Delete an authorization

                                                                                                          DELETE /authorizations/:id
                                                                                                          

                                                                                                          Response

                                                                                                          Status: 204 No Content
                                                                                                          

                                                                                                          Check an authorization

                                                                                                          OAuth applications can use a special API method for checking OAuth token validity without running afoul of normal rate limits for failed login attempts. Authentication works differently with this particular endpoint. You must use Basic Authentication when accessing it, where the username is the OAuth application client_id and the password is its client_secret. Invalid tokens will return 404 NOT FOUND.

                                                                                                          GET /applications/:client_id/tokens/:access_token
                                                                                                          

                                                                                                          Response

                                                                                                          Status: 200 OK
                                                                                                          
                                                                                                          {
                                                                                                            "id": 1,
                                                                                                            "url": "https://api.github.com/authorizations/1",
                                                                                                            "scopes": [
                                                                                                              "public_repo"
                                                                                                            ],
                                                                                                            "token": "abcdefgh12345678",
                                                                                                            "token_last_eight": "12345678",
                                                                                                            "hashed_token": "25f94a2a5c7fbaf499c665bc73d67c1c87e496da8985131633ee0a95819db2e8",
                                                                                                            "app": {
                                                                                                              "url": "http://my-github-app.com",
                                                                                                              "name": "my github app",
                                                                                                              "client_id": "abcde12345fghij67890"
                                                                                                            },
                                                                                                            "note": "optional note",
                                                                                                            "note_url": "http://optional/note/url",
                                                                                                            "updated_at": "2011-09-06T20:39:23Z",
                                                                                                            "created_at": "2011-09-06T17:26:27Z",
                                                                                                            "fingerprint": "jklmnop12345678",
                                                                                                            "user": {
                                                                                                              "login": "octocat",
                                                                                                              "id": 1,
                                                                                                              "avatar_url": "https://github.com/images/error/octocat_happy.gif",
                                                                                                              "gravatar_id": "",
                                                                                                              "url": "https://api.github.com/users/octocat",
                                                                                                              "html_url": "https://github.com/octocat",
                                                                                                              "followers_url": "https://api.github.com/users/octocat/followers",
                                                                                                              "following_url": "https://api.github.com/users/octocat/following{/other_user}",
                                                                                                              "gists_url": "https://api.github.com/users/octocat/gists{/gist_id}",
                                                                                                              "starred_url": "https://api.github.com/users/octocat/starred{/owner}{/repo}",
                                                                                                              "subscriptions_url": "https://api.github.com/users/octocat/subscriptions",
                                                                                                              "organizations_url": "https://api.github.com/users/octocat/orgs",
                                                                                                              "repos_url": "https://api.github.com/users/octocat/repos",
                                                                                                              "events_url": "https://api.github.com/users/octocat/events{/privacy}",
                                                                                                              "received_events_url": "https://api.github.com/users/octocat/received_events",
                                                                                                              "type": "User",
                                                                                                              "site_admin": false
                                                                                                            }
                                                                                                          }
                                                                                                          

                                                                                                          Reset an authorization

                                                                                                          OAuth applications can use this API method to reset a valid OAuth token without end user involvement. Applications must save the "token" property in the response, because changes take effect immediately. You must use Basic Authentication when accessing it, where the username is the OAuth application client_id and the password is its client_secret. Invalid tokens will return 404 NOT FOUND.

                                                                                                          POST /applications/:client_id/tokens/:access_token
                                                                                                          

                                                                                                          Response

                                                                                                          Status: 200 OK
                                                                                                          
                                                                                                          {
                                                                                                            "id": 1,
                                                                                                            "url": "https://api.github.com/authorizations/1",
                                                                                                            "scopes": [
                                                                                                              "public_repo"
                                                                                                            ],
                                                                                                            "token": "abcdefgh12345678",
                                                                                                            "token_last_eight": "12345678",
                                                                                                            "hashed_token": "25f94a2a5c7fbaf499c665bc73d67c1c87e496da8985131633ee0a95819db2e8",
                                                                                                            "app": {
                                                                                                              "url": "http://my-github-app.com",
                                                                                                              "name": "my github app",
                                                                                                              "client_id": "abcde12345fghij67890"
                                                                                                            },
                                                                                                            "note": "optional note",
                                                                                                            "note_url": "http://optional/note/url",
                                                                                                            "updated_at": "2011-09-06T20:39:23Z",
                                                                                                            "created_at": "2011-09-06T17:26:27Z",
                                                                                                            "fingerprint": "jklmnop12345678",
                                                                                                            "user": {
                                                                                                              "login": "octocat",
                                                                                                              "id": 1,
                                                                                                              "avatar_url": "https://github.com/images/error/octocat_happy.gif",
                                                                                                              "gravatar_id": "",
                                                                                                              "url": "https://api.github.com/users/octocat",
                                                                                                              "html_url": "https://github.com/octocat",
                                                                                                              "followers_url": "https://api.github.com/users/octocat/followers",
                                                                                                              "following_url": "https://api.github.com/users/octocat/following{/other_user}",
                                                                                                              "gists_url": "https://api.github.com/users/octocat/gists{/gist_id}",
                                                                                                              "starred_url": "https://api.github.com/users/octocat/starred{/owner}{/repo}",
                                                                                                              "subscriptions_url": "https://api.github.com/users/octocat/subscriptions",
                                                                                                              "organizations_url": "https://api.github.com/users/octocat/orgs",
                                                                                                              "repos_url": "https://api.github.com/users/octocat/repos",
                                                                                                              "events_url": "https://api.github.com/users/octocat/events{/privacy}",
                                                                                                              "received_events_url": "https://api.github.com/users/octocat/received_events",
                                                                                                              "type": "User",
                                                                                                              "site_admin": false
                                                                                                            }
                                                                                                          }
                                                                                                          

                                                                                                          Revoke an authorization for an application

                                                                                                          OAuth application owners can revoke a single token for an OAuth application. You must use Basic Authentication for this method, where the username is the OAuth application client_id and the password is its client_secret.

                                                                                                          DELETE /applications/:client_id/tokens/:access_token
                                                                                                          

                                                                                                          Response

                                                                                                          Status: 204 No Content
                                                                                                          

                                                                                                          Revoke a grant for an application

                                                                                                          OAuth application owners can revoke a grant for their OAuth application and a specific user. You must use Basic Authentication for this method, where the username is the OAuth application client_id and the password is its client_secret. You must also provide a valid token as :token and the grant for the token's owner will be deleted.

                                                                                                          Deleting an OAuth application's grant will also delete all OAuth tokens associated with the application for the user. Once deleted, the application will have no access to the user's account and will no longer be listed on the application authorizations settings screen within GitHub.

                                                                                                          DELETE /applications/:client_id/grants/:access_token
                                                                                                          

                                                                                                          Response

                                                                                                          Status: 204 No Content
                                                                                                          

                                                                                                          More Information

                                                                                                          It can be a little tricky to get started with OAuth. Here are a few links that might be of help:

                                                                                                          tmp/developer.github.com/v3/orgs/index.html Organizations | GitHub Developer Guide

                                                                                                          Organizations

                                                                                                          Note: To help with migrating from our REST API v3 to GraphQL API v4, we're introducing a preview period to include the GraphQL node_id in the response for many REST API v3 resources. See the blog post for full details. To access node_id during the preview period, you must provide a custom media type in the Accept header:

                                                                                                          application/vnd.github.jean-grey-preview+json
                                                                                                          

                                                                                                          Warning: The API may change without advance notice during the preview period. Preview features are not supported for production use. If you experience any issues, contact GitHub support.

                                                                                                          List your organizations

                                                                                                          List organizations for the authenticated user.

                                                                                                          OAuth scope requirements

                                                                                                          This only lists organizations that your authorization allows you to operate on in some way (e.g., you can list teams with read:org scope, you can publicize your organization membership with user scope, etc.). Therefore, this API requires at least user or read:org scope. OAuth requests with insufficient scope receive a 403 Forbidden response.

                                                                                                          GET /user/orgs
                                                                                                          

                                                                                                          Response

                                                                                                          Status: 200 OK
                                                                                                          Link: <https://api.github.com/resource?page=2>; rel="next",
                                                                                                                <https://api.github.com/resource?page=5>; rel="last"
                                                                                                          
                                                                                                          [
                                                                                                            {
                                                                                                              "login": "github",
                                                                                                              "id": 1,
                                                                                                              "url": "https://api.github.com/orgs/github",
                                                                                                              "repos_url": "https://api.github.com/orgs/github/repos",
                                                                                                              "events_url": "https://api.github.com/orgs/github/events",
                                                                                                              "hooks_url": "https://api.github.com/orgs/github/hooks",
                                                                                                              "issues_url": "https://api.github.com/orgs/github/issues",
                                                                                                              "members_url": "https://api.github.com/orgs/github/members{/member}",
                                                                                                              "public_members_url": "https://api.github.com/orgs/github/public_members{/member}",
                                                                                                              "avatar_url": "https://github.com/images/error/octocat_happy.gif",
                                                                                                              "description": "A great organization"
                                                                                                            }
                                                                                                          ]
                                                                                                          

                                                                                                          List all organizations

                                                                                                          Lists all organizations, in the order that they were created on GitHub.

                                                                                                          Note: Pagination is powered exclusively by the since parameter. Use the Link header to get the URL for the next page of organizations.

                                                                                                          GET /organizations
                                                                                                          

                                                                                                          Parameters

                                                                                                          Name Type Description
                                                                                                          since string The integer ID of the last Organization that you've seen.

                                                                                                          Response

                                                                                                          Status: 200 OK
                                                                                                          Link: <https://api.github.com/organizations?since=135>; rel="next"
                                                                                                          
                                                                                                          [
                                                                                                            {
                                                                                                              "login": "github",
                                                                                                              "id": 1,
                                                                                                              "url": "https://api.github.com/orgs/github",
                                                                                                              "repos_url": "https://api.github.com/orgs/github/repos",
                                                                                                              "events_url": "https://api.github.com/orgs/github/events",
                                                                                                              "hooks_url": "https://api.github.com/orgs/github/hooks",
                                                                                                              "issues_url": "https://api.github.com/orgs/github/issues",
                                                                                                              "members_url": "https://api.github.com/orgs/github/members{/member}",
                                                                                                              "public_members_url": "https://api.github.com/orgs/github/public_members{/member}",
                                                                                                              "avatar_url": "https://github.com/images/error/octocat_happy.gif",
                                                                                                              "description": "A great organization"
                                                                                                            }
                                                                                                          ]
                                                                                                          

                                                                                                          List user organizations

                                                                                                          List public organization memberships for the specified user.

                                                                                                          This method only lists public memberships, regardless of authentication. If you need to fetch all of the organization memberships (public and private) for the authenticated user, use the List your organizations API instead.

                                                                                                          GET /users/:username/orgs
                                                                                                          

                                                                                                          Response

                                                                                                          Status: 200 OK
                                                                                                          Link: <https://api.github.com/resource?page=2>; rel="next",
                                                                                                                <https://api.github.com/resource?page=5>; rel="last"
                                                                                                          
                                                                                                          [
                                                                                                            {
                                                                                                              "login": "github",
                                                                                                              "id": 1,
                                                                                                              "url": "https://api.github.com/orgs/github",
                                                                                                              "repos_url": "https://api.github.com/orgs/github/repos",
                                                                                                              "events_url": "https://api.github.com/orgs/github/events",
                                                                                                              "hooks_url": "https://api.github.com/orgs/github/hooks",
                                                                                                              "issues_url": "https://api.github.com/orgs/github/issues",
                                                                                                              "members_url": "https://api.github.com/orgs/github/members{/member}",
                                                                                                              "public_members_url": "https://api.github.com/orgs/github/public_members{/member}",
                                                                                                              "avatar_url": "https://github.com/images/error/octocat_happy.gif",
                                                                                                              "description": "A great organization"
                                                                                                            }
                                                                                                          ]
                                                                                                          

                                                                                                          Get an organization

                                                                                                          GET /orgs/:org
                                                                                                          

                                                                                                          Note: Many Organization response values require the user making the request to be authenticated, an organization owner, and have the admin:org scope authorized.

                                                                                                          Response

                                                                                                          Status: 200 OK
                                                                                                          
                                                                                                          {
                                                                                                            "login": "github",
                                                                                                            "id": 1,
                                                                                                            "url": "https://api.github.com/orgs/github",
                                                                                                            "repos_url": "https://api.github.com/orgs/github/repos",
                                                                                                            "events_url": "https://api.github.com/orgs/github/events",
                                                                                                            "hooks_url": "https://api.github.com/orgs/github/hooks",
                                                                                                            "issues_url": "https://api.github.com/orgs/github/issues",
                                                                                                            "members_url": "https://api.github.com/orgs/github/members{/member}",
                                                                                                            "public_members_url": "https://api.github.com/orgs/github/public_members{/member}",
                                                                                                            "avatar_url": "https://github.com/images/error/octocat_happy.gif",
                                                                                                            "description": "A great organization",
                                                                                                            "name": "github",
                                                                                                            "company": "GitHub",
                                                                                                            "blog": "https://github.com/blog",
                                                                                                            "location": "San Francisco",
                                                                                                            "email": "octocat@github.com",
                                                                                                            "public_repos": 2,
                                                                                                            "public_gists": 1,
                                                                                                            "followers": 20,
                                                                                                            "following": 0,
                                                                                                            "html_url": "https://github.com/octocat",
                                                                                                            "created_at": "2008-01-14T04:33:35Z",
                                                                                                            "type": "Organization",
                                                                                                            "total_private_repos": 100,
                                                                                                            "owned_private_repos": 100,
                                                                                                            "private_gists": 81,
                                                                                                            "disk_usage": 10000,
                                                                                                            "collaborators": 8,
                                                                                                            "billing_email": "support@github.com",
                                                                                                            "plan": {
                                                                                                              "name": "Medium",
                                                                                                              "space": 400,
                                                                                                              "private_repos": 20
                                                                                                            },
                                                                                                            "default_repository_settings": "read",
                                                                                                            "members_can_create_repositories": true
                                                                                                          }
                                                                                                          

                                                                                                          Edit an organization

                                                                                                          PATCH /orgs/:org
                                                                                                          

                                                                                                          Input

                                                                                                          Name Type Description
                                                                                                          billing_email string Billing email address. This address is not publicized.
                                                                                                          company string The company name.
                                                                                                          email string The publicly visible email address.
                                                                                                          location string The location.
                                                                                                          name string The shorthand name of the company.
                                                                                                          description string The description of the company.
                                                                                                          has_organization_projects boolean Toggles whether organization projects are enabled for the organization.
                                                                                                          has_repository_projects boolean Toggles whether repository projects are enabled for repositories that belong to the organization.
                                                                                                          default_repository_permission string Default permission level members have for organization repositories:
                                                                                                          * read - can pull, but not push to or administer this repository.
                                                                                                          * write - can pull and push, but not administer this repository.
                                                                                                          * admin - can pull, push, and administer this repository.
                                                                                                          * none - no permissions granted by default.
                                                                                                          Default: read
                                                                                                          members_can_create_repositories boolean Toggles ability of non-admin organization members to create repositories
                                                                                                          * true - all organization members can create repositories.
                                                                                                          * false - only admin members can create repositories.
                                                                                                          Default: true

                                                                                                          Example

                                                                                                          {
                                                                                                            "billing_email": "support@github.com",
                                                                                                            "blog": "https://github.com/blog",
                                                                                                            "company": "GitHub",
                                                                                                            "email": "support@github.com",
                                                                                                            "location": "San Francisco",
                                                                                                            "name": "github",
                                                                                                            "description": "GitHub, the company.",
                                                                                                            "default_repository_permission": "read",
                                                                                                            "members_can_create_repositories": true
                                                                                                          }
                                                                                                          

                                                                                                          Response

                                                                                                          Status: 200 OK
                                                                                                          
                                                                                                          {
                                                                                                            "login": "github",
                                                                                                            "id": 1,
                                                                                                            "url": "https://api.github.com/orgs/github",
                                                                                                            "repos_url": "https://api.github.com/orgs/github/repos",
                                                                                                            "events_url": "https://api.github.com/orgs/github/events",
                                                                                                            "hooks_url": "https://api.github.com/orgs/github/hooks",
                                                                                                            "issues_url": "https://api.github.com/orgs/github/issues",
                                                                                                            "members_url": "https://api.github.com/orgs/github/members{/member}",
                                                                                                            "public_members_url": "https://api.github.com/orgs/github/public_members{/member}",
                                                                                                            "avatar_url": "https://github.com/images/error/octocat_happy.gif",
                                                                                                            "description": "A great organization",
                                                                                                            "name": "github",
                                                                                                            "company": "GitHub",
                                                                                                            "blog": "https://github.com/blog",
                                                                                                            "location": "San Francisco",
                                                                                                            "email": "octocat@github.com",
                                                                                                            "public_repos": 2,
                                                                                                            "public_gists": 1,
                                                                                                            "followers": 20,
                                                                                                            "following": 0,
                                                                                                            "html_url": "https://github.com/octocat",
                                                                                                            "created_at": "2008-01-14T04:33:35Z",
                                                                                                            "type": "Organization",
                                                                                                            "total_private_repos": 100,
                                                                                                            "owned_private_repos": 100,
                                                                                                            "private_gists": 81,
                                                                                                            "disk_usage": 10000,
                                                                                                            "collaborators": 8,
                                                                                                            "billing_email": "support@github.com",
                                                                                                            "plan": {
                                                                                                              "name": "Medium",
                                                                                                              "space": 400,
                                                                                                              "private_repos": 20
                                                                                                            },
                                                                                                            "default_repository_settings": "read",
                                                                                                            "members_can_create_repositories": true,
                                                                                                            "has_organization_projects": true,
                                                                                                            "has_repository_projects": true
                                                                                                          }
                                                                                                          
                                                                                                          tmp/developer.github.com/v3/orgs/blocking/index.html Blocking Users (Organizations) | GitHub Developer Guide

                                                                                                          Blocking Users (Organizations)

                                                                                                          Note: The User Blocking API on GitHub is currently available for developers to preview. To access the API, you must provide a custom media type in the Accept header:

                                                                                                          application/vnd.github.giant-sentry-fist-preview+json
                                                                                                          

                                                                                                          Warning: The API may change without advance notice during the preview period. Preview features are not supported for production use. If you experience any issues, contact GitHub support.

                                                                                                          The token used to authenticate the call must have the admin:org scope in order to make any blocking calls for an organization. Otherwise, the response returns HTTP 404.

                                                                                                          List blocked users

                                                                                                          List the users blocked by an organization.

                                                                                                          GET /orgs/:org/blocks
                                                                                                          

                                                                                                          Response

                                                                                                          Status: 200 OK
                                                                                                          
                                                                                                          [
                                                                                                            {
                                                                                                              "login": "octocat",
                                                                                                              "id": 1,
                                                                                                              "avatar_url": "https://github.com/images/error/octocat_happy.gif",
                                                                                                              "gravatar_id": "",
                                                                                                              "url": "https://api.github.com/users/octocat",
                                                                                                              "html_url": "https://github.com/octocat",
                                                                                                              "followers_url": "https://api.github.com/users/octocat/followers",
                                                                                                              "following_url": "https://api.github.com/users/octocat/following{/other_user}",
                                                                                                              "gists_url": "https://api.github.com/users/octocat/gists{/gist_id}",
                                                                                                              "starred_url": "https://api.github.com/users/octocat/starred{/owner}{/repo}",
                                                                                                              "subscriptions_url": "https://api.github.com/users/octocat/subscriptions",
                                                                                                              "organizations_url": "https://api.github.com/users/octocat/orgs",
                                                                                                              "repos_url": "https://api.github.com/users/octocat/repos",
                                                                                                              "events_url": "https://api.github.com/users/octocat/events{/privacy}",
                                                                                                              "received_events_url": "https://api.github.com/users/octocat/received_events",
                                                                                                              "type": "User",
                                                                                                              "site_admin": false
                                                                                                            }
                                                                                                          ]
                                                                                                          

                                                                                                          Check whether a user is blocked from an organization

                                                                                                          GET /orgs/:org/blocks/:username
                                                                                                          

                                                                                                          Response

                                                                                                          If the user is blocked:

                                                                                                          Status: 204 No Content
                                                                                                          

                                                                                                          If the user is not blocked:

                                                                                                          Status: 404 Not Found
                                                                                                          

                                                                                                          Block a user

                                                                                                          PUT /orgs/:org/blocks/:username
                                                                                                          

                                                                                                          Response

                                                                                                          Status: 204 No Content
                                                                                                          

                                                                                                          Unblock a user

                                                                                                          DELETE /orgs/:org/blocks/:username
                                                                                                          

                                                                                                          Response

                                                                                                          Status: 204 No Content
                                                                                                          
                                                                                                          tmp/developer.github.com/v3/orgs/hooks/index.html Organization Webhooks | GitHub Developer Guide

                                                                                                          Webhooks

                                                                                                          Organization webhooks allow you to receive HTTP POST payloads whenever certain events happen within the organization. Subscribing to these events makes it possible to build integrations that react to actions on GitHub.com. For more information on actions you can subscribe to, check out our Events documentation.

                                                                                                          Scopes & Restrictions

                                                                                                          All actions against organization webhooks require the authenticated user to be an admin of the organization being managed. Additionally, OAuth tokens require the admin:org_hook scope.

                                                                                                          In order to protect sensitive data which may be present in webhook configurations, we also enforce the following access control rules:

                                                                                                          • OAuth applications cannot list, view, or edit webhooks which they did not create.
                                                                                                          • Users cannot list, view, or edit webhooks which were created by OAuth applications.

                                                                                                          List hooks

                                                                                                          GET /orgs/:org/hooks
                                                                                                          

                                                                                                          Response

                                                                                                          Status: 200 OK
                                                                                                          Link: <https://api.github.com/resource?page=2>; rel="next",
                                                                                                                <https://api.github.com/resource?page=5>; rel="last"
                                                                                                          
                                                                                                          [
                                                                                                            {
                                                                                                              "id": 1,
                                                                                                              "url": "https://api.github.com/orgs/octocat/hooks/1",
                                                                                                              "ping_url": "https://api.github.com/orgs/octocat/hooks/1/pings",
                                                                                                              "name": "web",
                                                                                                              "events": [
                                                                                                                "push",
                                                                                                                "pull_request"
                                                                                                              ],
                                                                                                              "active": true,
                                                                                                              "config": {
                                                                                                                "url": "http://example.com",
                                                                                                                "content_type": "json"
                                                                                                              },
                                                                                                              "updated_at": "2011-09-06T20:39:23Z",
                                                                                                              "created_at": "2011-09-06T17:26:27Z"
                                                                                                            }
                                                                                                          ]
                                                                                                          

                                                                                                          Get single hook

                                                                                                          GET /orgs/:org/hooks/:id
                                                                                                          

                                                                                                          Response

                                                                                                          Status: 200 OK
                                                                                                          
                                                                                                          {
                                                                                                            "id": 1,
                                                                                                            "url": "https://api.github.com/orgs/octocat/hooks/1",
                                                                                                            "ping_url": "https://api.github.com/orgs/octocat/hooks/1/pings",
                                                                                                            "name": "web",
                                                                                                            "events": [
                                                                                                              "push",
                                                                                                              "pull_request"
                                                                                                            ],
                                                                                                            "active": true,
                                                                                                            "config": {
                                                                                                              "url": "http://example.com",
                                                                                                              "content_type": "json"
                                                                                                            },
                                                                                                            "updated_at": "2011-09-06T20:39:23Z",
                                                                                                            "created_at": "2011-09-06T17:26:27Z"
                                                                                                          }
                                                                                                          

                                                                                                          Create a hook

                                                                                                          POST /orgs/:org/hooks
                                                                                                          

                                                                                                          Parameters

                                                                                                          Name Type Description
                                                                                                          name string Required. Must be passed as "web".
                                                                                                          config object Required. Key/value pairs to provide settings for this webhook. These are defined below.
                                                                                                          events array Determines what events the hook is triggered for. Default: ["push"].
                                                                                                          active boolean Determines if notifications are sent when the webhook is triggered. Set to true to send notifications. Default: true.

                                                                                                          The config object can accept the following keys:

                                                                                                          Name Type Description
                                                                                                          url string Required The URL to which the payloads will be delivered.
                                                                                                          content_type string The media type used to serialize the payloads. Supported values include json and form. The default is form.
                                                                                                          secret string If provided, the secret will be used as the key to generate the HMAC hex digest value in the X-Hub-Signature header.
                                                                                                          insecure_ssl string Determines whether the SSL certificate of the host for url will be verified when delivering payloads. Supported values include 0 (verification is performed) and 1 (verification is not performed). The default is 0. We strongly recommend not setting this to 1 as you are subject to man-in-the-middle and other attacks.

                                                                                                          Example

                                                                                                          Here's how you can create a hook that posts payloads in JSON format:

                                                                                                          {
                                                                                                            "name": "web",
                                                                                                            "active": true,
                                                                                                            "events": [
                                                                                                              "push",
                                                                                                              "pull_request"
                                                                                                            ],
                                                                                                            "config": {
                                                                                                              "url": "http://example.com/webhook",
                                                                                                              "content_type": "json"
                                                                                                            }
                                                                                                          }
                                                                                                          

                                                                                                          Response

                                                                                                          Status: 201 Created
                                                                                                          Location: https://api.github.com/orgs/octocat/hooks/1
                                                                                                          
                                                                                                          {
                                                                                                            "id": 1,
                                                                                                            "url": "https://api.github.com/orgs/octocat/hooks/1",
                                                                                                            "ping_url": "https://api.github.com/orgs/octocat/hooks/1/pings",
                                                                                                            "name": "web",
                                                                                                            "events": [
                                                                                                              "push",
                                                                                                              "pull_request"
                                                                                                            ],
                                                                                                            "active": true,
                                                                                                            "config": {
                                                                                                              "url": "http://example.com",
                                                                                                              "content_type": "json"
                                                                                                            },
                                                                                                            "updated_at": "2011-09-06T20:39:23Z",
                                                                                                            "created_at": "2011-09-06T17:26:27Z"
                                                                                                          }
                                                                                                          

                                                                                                          Edit a hook

                                                                                                          PATCH /orgs/:org/hooks/:id
                                                                                                          

                                                                                                          Parameters

                                                                                                          Name Type Description
                                                                                                          config object Required. Key/value pairs to provide settings for this webhook. These are defined below.
                                                                                                          events array Determines what events the hook is triggered for. Default: ["push"].
                                                                                                          active boolean Determines if notifications are sent when the webhook is triggered. Set to true to send notifications. Default: true.

                                                                                                          The config object can accept the following keys:

                                                                                                          Name Type Description
                                                                                                          url string Required The URL to which the payloads will be delivered.
                                                                                                          content_type string The media type used to serialize the payloads. Supported values include json and form. The default is form.
                                                                                                          secret string If provided, the secret will be used as the key to generate the HMAC hex digest value in the X-Hub-Signature header.
                                                                                                          insecure_ssl string Determines whether the SSL certificate of the host for url will be verified when delivering payloads. Supported values include 0 (verification is performed) and 1 (verification is not performed). The default is 0. We strongly recommend not setting this to 1 as you are subject to man-in-the-middle and other attacks.

                                                                                                          Example

                                                                                                          {
                                                                                                            "active": true,
                                                                                                            "events": [
                                                                                                              "pull_request"
                                                                                                            ]
                                                                                                          }
                                                                                                          

                                                                                                          Response

                                                                                                          Status: 200 OK
                                                                                                          
                                                                                                          {
                                                                                                            "id": 1,
                                                                                                            "url": "https://api.github.com/orgs/octocat/hooks/1",
                                                                                                            "ping_url": "https://api.github.com/orgs/octocat/hooks/1/pings",
                                                                                                            "name": "web",
                                                                                                            "events": [
                                                                                                              "pull_request"
                                                                                                            ],
                                                                                                            "active": true,
                                                                                                            "config": {
                                                                                                              "url": "http://example.com",
                                                                                                              "content_type": "json"
                                                                                                            },
                                                                                                            "updated_at": "2011-09-06T20:39:23Z",
                                                                                                            "created_at": "2011-09-06T17:26:27Z"
                                                                                                          }
                                                                                                          

                                                                                                          Ping a hook

                                                                                                          This will trigger a ping event to be sent to the hook.

                                                                                                          POST /orgs/:org/hooks/:id/pings
                                                                                                          

                                                                                                          Response

                                                                                                          Status: 204 No Content
                                                                                                          

                                                                                                          Delete a hook

                                                                                                          DELETE /orgs/:org/hooks/:id
                                                                                                          

                                                                                                          Response

                                                                                                          Status: 204 No Content
                                                                                                          

                                                                                                          Receiving Webhooks

                                                                                                          In order for GitHub to send webhook payloads, your server needs to be accessible from the Internet. We also highly suggest using SSL so that we can send encrypted payloads over HTTPS.

                                                                                                          For more best practices, see our guide.

                                                                                                          Webhook headers

                                                                                                          GitHub will send along several HTTP headers to differentiate between event types and payload identifiers. See webhook headers for details.

                                                                                                          tmp/developer.github.com/v3/orgs/members/index.html Organization Members | GitHub Developer Guide

                                                                                                          Members

                                                                                                          Members list

                                                                                                          List all users who are members of an organization. If the authenticated user is also a member of this organization then both concealed and public members will be returned.

                                                                                                          GET /orgs/:org/members
                                                                                                          

                                                                                                          Parameters

                                                                                                          Name Type Description
                                                                                                          filter string Filter members returned in the list. Can be one of:
                                                                                                          * 2fa_disabled - Members without two-factor authentication enabled. Available for organization owners.
                                                                                                          * all - All members the authenticated user can see.

                                                                                                          Default: all
                                                                                                          role string Filter members returned by their role. Can be one of:
                                                                                                          * all - All members of the organization, regardless of role.
                                                                                                          * admin - Organization owners.
                                                                                                          * member - Non-owner organization members.

                                                                                                          Default: all

                                                                                                          Response

                                                                                                          Status: 200 OK
                                                                                                          Link: <https://api.github.com/resource?page=2>; rel="next",
                                                                                                                <https://api.github.com/resource?page=5>; rel="last"
                                                                                                          
                                                                                                          [
                                                                                                            {
                                                                                                              "login": "octocat",
                                                                                                              "id": 1,
                                                                                                              "avatar_url": "https://github.com/images/error/octocat_happy.gif",
                                                                                                              "gravatar_id": "",
                                                                                                              "url": "https://api.github.com/users/octocat",
                                                                                                              "html_url": "https://github.com/octocat",
                                                                                                              "followers_url": "https://api.github.com/users/octocat/followers",
                                                                                                              "following_url": "https://api.github.com/users/octocat/following{/other_user}",
                                                                                                              "gists_url": "https://api.github.com/users/octocat/gists{/gist_id}",
                                                                                                              "starred_url": "https://api.github.com/users/octocat/starred{/owner}{/repo}",
                                                                                                              "subscriptions_url": "https://api.github.com/users/octocat/subscriptions",
                                                                                                              "organizations_url": "https://api.github.com/users/octocat/orgs",
                                                                                                              "repos_url": "https://api.github.com/users/octocat/repos",
                                                                                                              "events_url": "https://api.github.com/users/octocat/events{/privacy}",
                                                                                                              "received_events_url": "https://api.github.com/users/octocat/received_events",
                                                                                                              "type": "User",
                                                                                                              "site_admin": false
                                                                                                            }
                                                                                                          ]
                                                                                                          

                                                                                                          Response if requester is not an organization member

                                                                                                          Status: 302 Found
                                                                                                          Location: https://api.github.com/orgs/github/public_members
                                                                                                          

                                                                                                          Check membership

                                                                                                          Check if a user is, publicly or privately, a member of the organization.

                                                                                                          GET /orgs/:org/members/:username
                                                                                                          

                                                                                                          Response if requester is an organization member and user is a member

                                                                                                          Status: 204 No Content
                                                                                                          

                                                                                                          Response if requester is an organization member and user is not a member

                                                                                                          Status: 404 Not Found
                                                                                                          

                                                                                                          Response if requester is not an organization member and is inquiring about themselves

                                                                                                          Status: 404 Not Found
                                                                                                          

                                                                                                          Response if requester is not an organization member

                                                                                                          Status: 302 Found
                                                                                                          Location: https://api.github.com/orgs/github/public_members/pezra
                                                                                                          

                                                                                                          Add a member

                                                                                                          To add someone as a member to an organization, you must invite them to the organization or invite them to a team.

                                                                                                          Remove a member

                                                                                                          Removing a user from this list will remove them from all teams and they will no longer have any access to the organization's repositories.

                                                                                                          DELETE /orgs/:org/members/:username
                                                                                                          

                                                                                                          Response

                                                                                                          Status: 204 No Content
                                                                                                          

                                                                                                          Public members list

                                                                                                          Members of an organization can choose to have their membership publicized or not.

                                                                                                          GET /orgs/:org/public_members
                                                                                                          

                                                                                                          Response

                                                                                                          Status: 200 OK
                                                                                                          Link: <https://api.github.com/resource?page=2>; rel="next",
                                                                                                                <https://api.github.com/resource?page=5>; rel="last"
                                                                                                          
                                                                                                          [
                                                                                                            {
                                                                                                              "login": "octocat",
                                                                                                              "id": 1,
                                                                                                              "avatar_url": "https://github.com/images/error/octocat_happy.gif",
                                                                                                              "gravatar_id": "",
                                                                                                              "url": "https://api.github.com/users/octocat",
                                                                                                              "html_url": "https://github.com/octocat",
                                                                                                              "followers_url": "https://api.github.com/users/octocat/followers",
                                                                                                              "following_url": "https://api.github.com/users/octocat/following{/other_user}",
                                                                                                              "gists_url": "https://api.github.com/users/octocat/gists{/gist_id}",
                                                                                                              "starred_url": "https://api.github.com/users/octocat/starred{/owner}{/repo}",
                                                                                                              "subscriptions_url": "https://api.github.com/users/octocat/subscriptions",
                                                                                                              "organizations_url": "https://api.github.com/users/octocat/orgs",
                                                                                                              "repos_url": "https://api.github.com/users/octocat/repos",
                                                                                                              "events_url": "https://api.github.com/users/octocat/events{/privacy}",
                                                                                                              "received_events_url": "https://api.github.com/users/octocat/received_events",
                                                                                                              "type": "User",
                                                                                                              "site_admin": false
                                                                                                            }
                                                                                                          ]
                                                                                                          

                                                                                                          Check public membership

                                                                                                          GET /orgs/:org/public_members/:username
                                                                                                          

                                                                                                          Response if user is a public member

                                                                                                          Status: 204 No Content
                                                                                                          

                                                                                                          Response if user is not a public member

                                                                                                          Status: 404 Not Found
                                                                                                          

                                                                                                          Publicize a user's membership

                                                                                                          The user can publicize their own membership. (A user cannot publicize the membership for another user.)

                                                                                                          PUT /orgs/:org/public_members/:username
                                                                                                          

                                                                                                          Note that you'll need to set Content-Length to zero when calling out to this endpoint. For more information, see "HTTP verbs."

                                                                                                          Response

                                                                                                          Status: 204 No Content
                                                                                                          

                                                                                                          Conceal a user's membership

                                                                                                          DELETE /orgs/:org/public_members/:username
                                                                                                          

                                                                                                          Response

                                                                                                          Status: 204 No Content
                                                                                                          

                                                                                                          Get organization membership

                                                                                                          In order to get a user's membership with an organization, the authenticated user must be an organization member.

                                                                                                          GET /orgs/:org/memberships/:username
                                                                                                          

                                                                                                          Response if user has an active admin membership with organization

                                                                                                          Status: 200 OK
                                                                                                          
                                                                                                          {
                                                                                                            "url": "https://api.github.com/orgs/octocat/memberships/defunkt",
                                                                                                            "state": "active",
                                                                                                            "role": "admin",
                                                                                                            "organization_url": "https://api.github.com/orgs/octocat",
                                                                                                            "organization": {
                                                                                                              "login": "octocat",
                                                                                                              "url": "https://api.github.com/orgs/octocat",
                                                                                                              "id": 1,
                                                                                                              "repos_url": "https://api.github.com/users/octocat/repos",
                                                                                                              "events_url": "https://api.github.com/users/octocat/events{/privacy}",
                                                                                                              "members_url": "https://api.github.com/users/octocat/members{/member}",
                                                                                                              "public_members_url": "https://api.github/com/users/octocat/public_members{/member}",
                                                                                                              "avatar_url": "https://secure.gravatar.com/avatar/7ad39074b0584bc555d0417ae3e7d974?d=https://a248.e.akamai.net/assets.github.com%2Fimages%2Fgravatars%2Fgravatar-140.png"
                                                                                                            },
                                                                                                            "user": {
                                                                                                              "login": "defunkt",
                                                                                                              "id": 3,
                                                                                                              "avatar_url": "https://github.com/images/error/octocat_happy.gif",
                                                                                                              "gravatar_id": "",
                                                                                                              "url": "https://api.github.com/users/defunkt",
                                                                                                              "html_url": "https://github.com/defunkt",
                                                                                                              "followers_url": "https://api.github.com/users/defunkt/followers",
                                                                                                              "following_url": "https://api.github.com/users/defunkt/following{/other_user}",
                                                                                                              "gists_url": "https://api.github.com/users/defunkt/gists{/gist_id}",
                                                                                                              "starred_url": "https://api.github.com/users/defunkt/starred{/owner}{/repo}",
                                                                                                              "subscriptions_url": "https://api.github.com/users/defunkt/subscriptions",
                                                                                                              "organizations_url": "https://api.github.com/users/defunkt/orgs",
                                                                                                              "repos_url": "https://api.github.com/users/defunkt/repos",
                                                                                                              "events_url": "https://api.github.com/users/defunkt/events{/privacy}",
                                                                                                              "received_events_url": "https://api.github.com/users/defunkt/received_events",
                                                                                                              "type": "User",
                                                                                                              "site_admin": false
                                                                                                            }
                                                                                                          }
                                                                                                          

                                                                                                          Response if user has an active membership with organization

                                                                                                          Status: 200 OK
                                                                                                          
                                                                                                          {
                                                                                                            "url": "https://api.github.com/orgs/octocat/memberships/defunkt",
                                                                                                            "state": "active",
                                                                                                            "role": "limited_member",
                                                                                                            "organization_url": "https://api.github.com/orgs/octocat",
                                                                                                            "organization": {
                                                                                                              "login": "octocat",
                                                                                                              "url": "https://api.github.com/orgs/octocat",
                                                                                                              "id": 1,
                                                                                                              "repos_url": "https://api.github.com/users/octocat/repos",
                                                                                                              "events_url": "https://api.github.com/users/octocat/events{/privacy}",
                                                                                                              "members_url": "https://api.github.com/users/octocat/members{/member}",
                                                                                                              "public_members_url": "https://api.github/com/users/octocat/public_members{/member}",
                                                                                                              "avatar_url": "https://secure.gravatar.com/avatar/7ad39074b0584bc555d0417ae3e7d974?d=https://a248.e.akamai.net/assets.github.com%2Fimages%2Fgravatars%2Fgravatar-140.png"
                                                                                                            },
                                                                                                            "user": {
                                                                                                              "login": "defunkt",
                                                                                                              "id": 3,
                                                                                                              "avatar_url": "https://github.com/images/error/octocat_happy.gif",
                                                                                                              "gravatar_id": "",
                                                                                                              "url": "https://api.github.com/users/defunkt",
                                                                                                              "html_url": "https://github.com/defunkt",
                                                                                                              "followers_url": "https://api.github.com/users/defunkt/followers",
                                                                                                              "following_url": "https://api.github.com/users/defunkt/following{/other_user}",
                                                                                                              "gists_url": "https://api.github.com/users/defunkt/gists{/gist_id}",
                                                                                                              "starred_url": "https://api.github.com/users/defunkt/starred{/owner}{/repo}",
                                                                                                              "subscriptions_url": "https://api.github.com/users/defunkt/subscriptions",
                                                                                                              "organizations_url": "https://api.github.com/users/defunkt/orgs",
                                                                                                              "repos_url": "https://api.github.com/users/defunkt/repos",
                                                                                                              "events_url": "https://api.github.com/users/defunkt/events{/privacy}",
                                                                                                              "received_events_url": "https://api.github.com/users/defunkt/received_events",
                                                                                                              "type": "User",
                                                                                                              "site_admin": false
                                                                                                            }
                                                                                                          }
                                                                                                          

                                                                                                          Response if user has a pending membership with organization

                                                                                                          Status: 200 OK
                                                                                                          
                                                                                                          {
                                                                                                            "url": "https://api.github.com/orgs/invitocat/memberships/defunkt",
                                                                                                            "state": "pending",
                                                                                                            "role": "limited_member",
                                                                                                            "organization_url": "https://api.github.com/orgs/invitocat",
                                                                                                            "organization": {
                                                                                                              "login": "invitocat",
                                                                                                              "url": "https://api.github.com/orgs/invitocat",
                                                                                                              "id": 2,
                                                                                                              "repos_url": "https://api.github.com/users/invitocat/repos",
                                                                                                              "events_url": "https://api.github.com/users/invitocat/events{/privacy}",
                                                                                                              "members_url": "https://api.github.com/users/invitocat/members{/member}",
                                                                                                              "public_members_url": "https://api.github/com/users/invitocat/public_members{/member}",
                                                                                                              "avatar_url": "https://secure.gravatar.com/avatar/7ad39074b0584bc555d0417ae3e7d974?d=https://a248.e.akamai.net/assets.github.com%2Fimages%2Fgravatars%2Fgravatar-140.png"
                                                                                                            },
                                                                                                            "user": {
                                                                                                              "login": "defunkt",
                                                                                                              "id": 3,
                                                                                                              "avatar_url": "https://github.com/images/error/octocat_happy.gif",
                                                                                                              "gravatar_id": "",
                                                                                                              "url": "https://api.github.com/users/defunkt",
                                                                                                              "html_url": "https://github.com/defunkt",
                                                                                                              "followers_url": "https://api.github.com/users/defunkt/followers",
                                                                                                              "following_url": "https://api.github.com/users/defunkt/following{/other_user}",
                                                                                                              "gists_url": "https://api.github.com/users/defunkt/gists{/gist_id}",
                                                                                                              "starred_url": "https://api.github.com/users/defunkt/starred{/owner}{/repo}",
                                                                                                              "subscriptions_url": "https://api.github.com/users/defunkt/subscriptions",
                                                                                                              "organizations_url": "https://api.github.com/users/defunkt/orgs",
                                                                                                              "repos_url": "https://api.github.com/users/defunkt/repos",
                                                                                                              "events_url": "https://api.github.com/users/defunkt/events{/privacy}",
                                                                                                              "received_events_url": "https://api.github.com/users/defunkt/received_events",
                                                                                                              "type": "User",
                                                                                                              "site_admin": false
                                                                                                            }
                                                                                                          }
                                                                                                          

                                                                                                          Add or update organization membership

                                                                                                          In order to create or update a user's membership with an organization, the authenticated user must be an organization owner.

                                                                                                          • If the authenticated user is adding a member to the organization, the invited user will receive an email inviting them to the organization. The user's membership status will be pending until they accept the invitation.

                                                                                                          • Authenticated users can update a user's membership by passing the role parameter. If the authenticated user changes a member's role to admin, the affected user will receive an email notifying them that they've been made an organization owner. If the authenticated user changes an owner's role to member, no email will be sent.

                                                                                                          PUT /orgs/:org/memberships/:username
                                                                                                          

                                                                                                          Parameters

                                                                                                          Name Type Description
                                                                                                          role string The role to give the user in the organization. Can be one of:
                                                                                                          * admin - The user will become an owner of the organization.
                                                                                                          * member - The user will become a non-owner member of the organization.

                                                                                                          Default: member

                                                                                                          Rate limits

                                                                                                          To prevent abuse, the authenticated user is limited to 50 organization invitations per 24 hour period. If the organization is more than one month old or on a paid plan, the limit is 500 invitations per 24 hour period.

                                                                                                          Response if user was previously unaffiliated with organization

                                                                                                          Status: 200 OK
                                                                                                          
                                                                                                          {
                                                                                                            "url": "https://api.github.com/orgs/invitocat/memberships/defunkt",
                                                                                                            "state": "pending",
                                                                                                            "role": "admin",
                                                                                                            "organization_url": "https://api.github.com/orgs/invitocat",
                                                                                                            "organization": {
                                                                                                              "login": "invitocat",
                                                                                                              "url": "https://api.github.com/orgs/invitocat",
                                                                                                              "id": 2,
                                                                                                              "repos_url": "https://api.github.com/users/invitocat/repos",
                                                                                                              "events_url": "https://api.github.com/users/invitocat/events{/privacy}",
                                                                                                              "members_url": "https://api.github.com/users/invitocat/members{/member}",
                                                                                                              "public_members_url": "https://api.github/com/users/invitocat/public_members{/member}",
                                                                                                              "avatar_url": "https://secure.gravatar.com/avatar/7ad39074b0584bc555d0417ae3e7d974?d=https://a248.e.akamai.net/assets.github.com%2Fimages%2Fgravatars%2Fgravatar-140.png"
                                                                                                            },
                                                                                                            "user": {
                                                                                                              "login": "defunkt",
                                                                                                              "id": 3,
                                                                                                              "avatar_url": "https://github.com/images/error/octocat_happy.gif",
                                                                                                              "gravatar_id": "",
                                                                                                              "url": "https://api.github.com/users/defunkt",
                                                                                                              "html_url": "https://github.com/defunkt",
                                                                                                              "followers_url": "https://api.github.com/users/defunkt/followers",
                                                                                                              "following_url": "https://api.github.com/users/defunkt/following{/other_user}",
                                                                                                              "gists_url": "https://api.github.com/users/defunkt/gists{/gist_id}",
                                                                                                              "starred_url": "https://api.github.com/users/defunkt/starred{/owner}{/repo}",
                                                                                                              "subscriptions_url": "https://api.github.com/users/defunkt/subscriptions",
                                                                                                              "organizations_url": "https://api.github.com/users/defunkt/orgs",
                                                                                                              "repos_url": "https://api.github.com/users/defunkt/repos",
                                                                                                              "events_url": "https://api.github.com/users/defunkt/events{/privacy}",
                                                                                                              "received_events_url": "https://api.github.com/users/defunkt/received_events",
                                                                                                              "type": "User",
                                                                                                              "site_admin": false
                                                                                                            }
                                                                                                          }
                                                                                                          

                                                                                                          Response if user already had membership with organization

                                                                                                          Status: 200 OK
                                                                                                          
                                                                                                          {
                                                                                                            "url": "https://api.github.com/orgs/octocat/memberships/defunkt",
                                                                                                            "state": "active",
                                                                                                            "role": "admin",
                                                                                                            "organization_url": "https://api.github.com/orgs/octocat",
                                                                                                            "organization": {
                                                                                                              "login": "octocat",
                                                                                                              "url": "https://api.github.com/orgs/octocat",
                                                                                                              "id": 1,
                                                                                                              "repos_url": "https://api.github.com/users/octocat/repos",
                                                                                                              "events_url": "https://api.github.com/users/octocat/events{/privacy}",
                                                                                                              "members_url": "https://api.github.com/users/octocat/members{/member}",
                                                                                                              "public_members_url": "https://api.github/com/users/octocat/public_members{/member}",
                                                                                                              "avatar_url": "https://secure.gravatar.com/avatar/7ad39074b0584bc555d0417ae3e7d974?d=https://a248.e.akamai.net/assets.github.com%2Fimages%2Fgravatars%2Fgravatar-140.png"
                                                                                                            },
                                                                                                            "user": {
                                                                                                              "login": "defunkt",
                                                                                                              "id": 3,
                                                                                                              "avatar_url": "https://github.com/images/error/octocat_happy.gif",
                                                                                                              "gravatar_id": "",
                                                                                                              "url": "https://api.github.com/users/defunkt",
                                                                                                              "html_url": "https://github.com/defunkt",
                                                                                                              "followers_url": "https://api.github.com/users/defunkt/followers",
                                                                                                              "following_url": "https://api.github.com/users/defunkt/following{/other_user}",
                                                                                                              "gists_url": "https://api.github.com/users/defunkt/gists{/gist_id}",
                                                                                                              "starred_url": "https://api.github.com/users/defunkt/starred{/owner}{/repo}",
                                                                                                              "subscriptions_url": "https://api.github.com/users/defunkt/subscriptions",
                                                                                                              "organizations_url": "https://api.github.com/users/defunkt/orgs",
                                                                                                              "repos_url": "https://api.github.com/users/defunkt/repos",
                                                                                                              "events_url": "https://api.github.com/users/defunkt/events{/privacy}",
                                                                                                              "received_events_url": "https://api.github.com/users/defunkt/received_events",
                                                                                                              "type": "User",
                                                                                                              "site_admin": false
                                                                                                            }
                                                                                                          }
                                                                                                          

                                                                                                          Remove organization membership

                                                                                                          In order to remove a user's membership with an organization, the authenticated user must be an organization owner.

                                                                                                          DELETE /orgs/:org/memberships/:username
                                                                                                          

                                                                                                          If the specified user is an active member of the organization, this will remove them from the organization. If the specified user has been invited to the organization, this will cancel their invitation. The specified user will receive an email notification in both cases.

                                                                                                          Response

                                                                                                          Status: 204 No Content
                                                                                                          

                                                                                                          List organization invitation teams

                                                                                                          Note: You can now use the API to invite users to a GitHub organization. This feature is currently available for developers to preview. See the blog post for full details. To access this feature, you must provide a custom media type in the Accept header:

                                                                                                          application/vnd.github.dazzler-preview+json
                                                                                                          

                                                                                                          Warning: The API may change without advance notice during the preview period. Preview features are not supported for production use. If you experience any issues, contact GitHub support.

                                                                                                          List all teams associated with an invitation. In order to see invitations in an organization, the authenticated user must be an organization owner.

                                                                                                          GET /orgs/:org/invitations/:invitation_id/teams
                                                                                                          

                                                                                                          Response

                                                                                                          Status: 200 OK
                                                                                                          Link: <https://api.github.com/resource?page=2>; rel="next",
                                                                                                                <https://api.github.com/resource?page=5>; rel="last"
                                                                                                          
                                                                                                          [
                                                                                                            {
                                                                                                              "id": 1,
                                                                                                              "url": "https://api.github.com/teams/1",
                                                                                                              "name": "Justice League",
                                                                                                              "slug": "justice-league",
                                                                                                              "description": "A great team.",
                                                                                                              "privacy": "closed",
                                                                                                              "permission": "admin",
                                                                                                              "members_url": "https://api.github.com/teams/1/members{/member}",
                                                                                                              "repositories_url": "https://api.github.com/teams/1/repos"
                                                                                                            }
                                                                                                          ]
                                                                                                          

                                                                                                          List pending organization invitations

                                                                                                          Note: You can now use the API to invite users to a GitHub organization. This feature is currently available for developers to preview. See the blog post for full details. To access this feature, you must provide a custom media type in the Accept header:

                                                                                                          application/vnd.github.dazzler-preview+json
                                                                                                          

                                                                                                          Warning: The API may change without advance notice during the preview period. Preview features are not supported for production use. If you experience any issues, contact GitHub support.

                                                                                                          The return hash contains a role field which refers to the Organization Invitation role and will be one of the following values: direct_member, admin, billing_manager, hiring_manager, or reinstate. If the invitee is not a GitHub member, the login field in the return hash will be null.

                                                                                                          GET /orgs/:org/invitations
                                                                                                          

                                                                                                          Response

                                                                                                          Status: 200 OK
                                                                                                          Link: <https://api.github.com/resource?page=2>; rel="next",
                                                                                                                <https://api.github.com/resource?page=5>; rel="last"
                                                                                                          
                                                                                                          [
                                                                                                            {
                                                                                                              "id": 1,
                                                                                                              "login": "monalisa",
                                                                                                              "email": "octocat@github.com",
                                                                                                              "role": "direct_member",
                                                                                                              "created_at": "2016-11-30T06:46:10-08:00",
                                                                                                              "inviter": {
                                                                                                                "login": "other_user",
                                                                                                                "id": 1,
                                                                                                                "avatar_url": "https://github.com/images/error/other_user_happy.gif",
                                                                                                                "gravatar_id": "",
                                                                                                                "url": "https://api.github.com/users/other_user",
                                                                                                                "html_url": "https://github.com/other_user",
                                                                                                                "followers_url": "https://api.github.com/users/other_user/followers",
                                                                                                                "following_url": "https://api.github.com/users/other_user/following{/other_user}",
                                                                                                                "gists_url": "https://api.github.com/users/other_user/gists{/gist_id}",
                                                                                                                "starred_url": "https://api.github.com/users/other_user/starred{/owner}{/repo}",
                                                                                                                "subscriptions_url": "https://api.github.com/users/other_user/subscriptions",
                                                                                                                "organizations_url": "https://api.github.com/users/other_user/orgs",
                                                                                                                "repos_url": "https://api.github.com/users/other_user/repos",
                                                                                                                "events_url": "https://api.github.com/users/other_user/events{/privacy}",
                                                                                                                "received_events_url": "https://api.github.com/users/other_user/received_events",
                                                                                                                "type": "User",
                                                                                                                "site_admin": false
                                                                                                              },
                                                                                                              "team_count": 2,
                                                                                                              "invitation_team_url": "https://api.github.com/organizations/2/invitations/1/teams"
                                                                                                            }
                                                                                                          ]
                                                                                                          

                                                                                                          Create organization invitation

                                                                                                          Note: You can now use the API to invite users to a GitHub organization. This feature is currently available for developers to preview. See the blog post for full details. To access this feature, you must provide a custom media type in the Accept header:

                                                                                                          application/vnd.github.dazzler-preview+json
                                                                                                          

                                                                                                          Warning: The API may change without advance notice during the preview period. Preview features are not supported for production use. If you experience any issues, contact GitHub support.

                                                                                                          Invite people to an organization by using their GitHub user ID or their email address. In order to create invitations in an organization, the authenticated user must be an organization owner.

                                                                                                          POST /orgs/:org/invitations
                                                                                                          

                                                                                                          Input

                                                                                                          Name Type Description
                                                                                                          invitee_id integer Required. GitHub user ID for the person you are inviting. Not required if you provide email.
                                                                                                          email string Required. Email address of the person you are inviting, which can be an existing GitHub user. Not required if you provide invitee_id.
                                                                                                          role string Specify role for new member. Can be one of:
                                                                                                          * admin - Organization owners with full administrative rights to the organization and complete access to all repositories and teams.
                                                                                                          * direct_member - Non-owner organization members with ability to see other members and join teams by invitation.
                                                                                                          * billing_manager - Non-owner organization members with ability to manage the billing settings of your organization.

                                                                                                          Default: direct_member.
                                                                                                          team_ids array Specify IDs for the teams you want to invite new members to.

                                                                                                          Example

                                                                                                          {
                                                                                                            "email": "octocat@github.com",
                                                                                                            "role": "direct_member",
                                                                                                            "team_id": [
                                                                                                              12,
                                                                                                              26
                                                                                                            ]
                                                                                                          }
                                                                                                          

                                                                                                          Response

                                                                                                          Status: 201 Created
                                                                                                          
                                                                                                          [
                                                                                                            {
                                                                                                              "id": 1,
                                                                                                              "login": "monalisa",
                                                                                                              "email": "octocat@github.com",
                                                                                                              "role": "direct_member",
                                                                                                              "created_at": "2016-11-30T06:46:10-08:00",
                                                                                                              "inviter": {
                                                                                                                "login": "other_user",
                                                                                                                "id": 1,
                                                                                                                "avatar_url": "https://github.com/images/error/other_user_happy.gif",
                                                                                                                "gravatar_id": "",
                                                                                                                "url": "https://api.github.com/users/other_user",
                                                                                                                "html_url": "https://github.com/other_user",
                                                                                                                "followers_url": "https://api.github.com/users/other_user/followers",
                                                                                                                "following_url": "https://api.github.com/users/other_user/following{/other_user}",
                                                                                                                "gists_url": "https://api.github.com/users/other_user/gists{/gist_id}",
                                                                                                                "starred_url": "https://api.github.com/users/other_user/starred{/owner}{/repo}",
                                                                                                                "subscriptions_url": "https://api.github.com/users/other_user/subscriptions",
                                                                                                                "organizations_url": "https://api.github.com/users/other_user/orgs",
                                                                                                                "repos_url": "https://api.github.com/users/other_user/repos",
                                                                                                                "events_url": "https://api.github.com/users/other_user/events{/privacy}",
                                                                                                                "received_events_url": "https://api.github.com/users/other_user/received_events",
                                                                                                                "type": "User",
                                                                                                                "site_admin": false
                                                                                                              },
                                                                                                              "team_count": 2,
                                                                                                              "invitation_team_url": "https://api.github.com/organizations/2/invitations/1/teams"
                                                                                                            }
                                                                                                          ]
                                                                                                          

                                                                                                          List your organization memberships

                                                                                                          GET /user/memberships/orgs
                                                                                                          

                                                                                                          Input

                                                                                                          Name Type Description
                                                                                                          state string Indicates the state of the memberships to return. Can be either active or pending. If not specified, the API returns both active and pending memberships.

                                                                                                          Response

                                                                                                          Status: 200 OK
                                                                                                          Link: <https://api.github.com/resource?page=2>; rel="next",
                                                                                                                <https://api.github.com/resource?page=5>; rel="last"
                                                                                                          
                                                                                                          [
                                                                                                            {
                                                                                                              "url": "https://api.github.com/orgs/octocat/memberships/defunkt",
                                                                                                              "state": "active",
                                                                                                              "role": "admin",
                                                                                                              "organization_url": "https://api.github.com/orgs/octocat",
                                                                                                              "organization": {
                                                                                                                "login": "octocat",
                                                                                                                "url": "https://api.github.com/orgs/octocat",
                                                                                                                "id": 1,
                                                                                                                "repos_url": "https://api.github.com/users/octocat/repos",
                                                                                                                "events_url": "https://api.github.com/users/octocat/events{/privacy}",
                                                                                                                "members_url": "https://api.github.com/users/octocat/members{/member}",
                                                                                                                "public_members_url": "https://api.github/com/users/octocat/public_members{/member}",
                                                                                                                "avatar_url": "https://secure.gravatar.com/avatar/7ad39074b0584bc555d0417ae3e7d974?d=https://a248.e.akamai.net/assets.github.com%2Fimages%2Fgravatars%2Fgravatar-140.png"
                                                                                                              },
                                                                                                              "user": {
                                                                                                                "login": "defunkt",
                                                                                                                "id": 3,
                                                                                                                "avatar_url": "https://github.com/images/error/octocat_happy.gif",
                                                                                                                "gravatar_id": "",
                                                                                                                "url": "https://api.github.com/users/defunkt",
                                                                                                                "html_url": "https://github.com/defunkt",
                                                                                                                "followers_url": "https://api.github.com/users/defunkt/followers",
                                                                                                                "following_url": "https://api.github.com/users/defunkt/following{/other_user}",
                                                                                                                "gists_url": "https://api.github.com/users/defunkt/gists{/gist_id}",
                                                                                                                "starred_url": "https://api.github.com/users/defunkt/starred{/owner}{/repo}",
                                                                                                                "subscriptions_url": "https://api.github.com/users/defunkt/subscriptions",
                                                                                                                "organizations_url": "https://api.github.com/users/defunkt/orgs",
                                                                                                                "repos_url": "https://api.github.com/users/defunkt/repos",
                                                                                                                "events_url": "https://api.github.com/users/defunkt/events{/privacy}",
                                                                                                                "received_events_url": "https://api.github.com/users/defunkt/received_events",
                                                                                                                "type": "User",
                                                                                                                "site_admin": false
                                                                                                              }
                                                                                                            },
                                                                                                            {
                                                                                                              "url": "https://api.github.com/orgs/invitocat/memberships/defunkt",
                                                                                                              "state": "pending",
                                                                                                              "role": "admin",
                                                                                                              "organization_url": "https://api.github.com/orgs/invitocat",
                                                                                                              "organization": {
                                                                                                                "login": "invitocat",
                                                                                                                "url": "https://api.github.com/orgs/invitocat",
                                                                                                                "id": 2,
                                                                                                                "repos_url": "https://api.github.com/users/invitocat/repos",
                                                                                                                "events_url": "https://api.github.com/users/invitocat/events{/privacy}",
                                                                                                                "members_url": "https://api.github.com/users/invitocat/members{/member}",
                                                                                                                "public_members_url": "https://api.github/com/users/invitocat/public_members{/member}",
                                                                                                                "avatar_url": "https://secure.gravatar.com/avatar/7ad39074b0584bc555d0417ae3e7d974?d=https://a248.e.akamai.net/assets.github.com%2Fimages%2Fgravatars%2Fgravatar-140.png"
                                                                                                              },
                                                                                                              "user": {
                                                                                                                "login": "defunkt",
                                                                                                                "id": 3,
                                                                                                                "avatar_url": "https://github.com/images/error/octocat_happy.gif",
                                                                                                                "gravatar_id": "",
                                                                                                                "url": "https://api.github.com/users/defunkt",
                                                                                                                "html_url": "https://github.com/defunkt",
                                                                                                                "followers_url": "https://api.github.com/users/defunkt/followers",
                                                                                                                "following_url": "https://api.github.com/users/defunkt/following{/other_user}",
                                                                                                                "gists_url": "https://api.github.com/users/defunkt/gists{/gist_id}",
                                                                                                                "starred_url": "https://api.github.com/users/defunkt/starred{/owner}{/repo}",
                                                                                                                "subscriptions_url": "https://api.github.com/users/defunkt/subscriptions",
                                                                                                                "organizations_url": "https://api.github.com/users/defunkt/orgs",
                                                                                                                "repos_url": "https://api.github.com/users/defunkt/repos",
                                                                                                                "events_url": "https://api.github.com/users/defunkt/events{/privacy}",
                                                                                                                "received_events_url": "https://api.github.com/users/defunkt/received_events",
                                                                                                                "type": "User",
                                                                                                                "site_admin": false
                                                                                                              }
                                                                                                            }
                                                                                                          ]
                                                                                                          

                                                                                                          Get your organization membership

                                                                                                          GET /user/memberships/orgs/:org
                                                                                                          

                                                                                                          Response

                                                                                                          Status: 200 OK
                                                                                                          
                                                                                                          {
                                                                                                            "url": "https://api.github.com/orgs/invitocat/memberships/defunkt",
                                                                                                            "state": "pending",
                                                                                                            "role": "admin",
                                                                                                            "organization_url": "https://api.github.com/orgs/invitocat",
                                                                                                            "organization": {
                                                                                                              "login": "invitocat",
                                                                                                              "url": "https://api.github.com/orgs/invitocat",
                                                                                                              "id": 2,
                                                                                                              "repos_url": "https://api.github.com/users/invitocat/repos",
                                                                                                              "events_url": "https://api.github.com/users/invitocat/events{/privacy}",
                                                                                                              "members_url": "https://api.github.com/users/invitocat/members{/member}",
                                                                                                              "public_members_url": "https://api.github/com/users/invitocat/public_members{/member}",
                                                                                                              "avatar_url": "https://secure.gravatar.com/avatar/7ad39074b0584bc555d0417ae3e7d974?d=https://a248.e.akamai.net/assets.github.com%2Fimages%2Fgravatars%2Fgravatar-140.png"
                                                                                                            },
                                                                                                            "user": {
                                                                                                              "login": "defunkt",
                                                                                                              "id": 3,
                                                                                                              "avatar_url": "https://github.com/images/error/octocat_happy.gif",
                                                                                                              "gravatar_id": "",
                                                                                                              "url": "https://api.github.com/users/defunkt",
                                                                                                              "html_url": "https://github.com/defunkt",
                                                                                                              "followers_url": "https://api.github.com/users/defunkt/followers",
                                                                                                              "following_url": "https://api.github.com/users/defunkt/following{/other_user}",
                                                                                                              "gists_url": "https://api.github.com/users/defunkt/gists{/gist_id}",
                                                                                                              "starred_url": "https://api.github.com/users/defunkt/starred{/owner}{/repo}",
                                                                                                              "subscriptions_url": "https://api.github.com/users/defunkt/subscriptions",
                                                                                                              "organizations_url": "https://api.github.com/users/defunkt/orgs",
                                                                                                              "repos_url": "https://api.github.com/users/defunkt/repos",
                                                                                                              "events_url": "https://api.github.com/users/defunkt/events{/privacy}",
                                                                                                              "received_events_url": "https://api.github.com/users/defunkt/received_events",
                                                                                                              "type": "User",
                                                                                                              "site_admin": false
                                                                                                            }
                                                                                                          }
                                                                                                          

                                                                                                          Edit your organization membership

                                                                                                          PATCH /user/memberships/orgs/:org
                                                                                                          

                                                                                                          Input

                                                                                                          Name Type Description
                                                                                                          state string Required. The state that the membership should be in. Only "active" will be accepted.

                                                                                                          Example

                                                                                                          {
                                                                                                            "state": "active"
                                                                                                          }
                                                                                                          

                                                                                                          Response

                                                                                                          Status: 200 OK
                                                                                                          
                                                                                                          {
                                                                                                            "url": "https://api.github.com/orgs/octocat/memberships/defunkt",
                                                                                                            "state": "active",
                                                                                                            "role": "admin",
                                                                                                            "organization_url": "https://api.github.com/orgs/octocat",
                                                                                                            "organization": {
                                                                                                              "login": "octocat",
                                                                                                              "url": "https://api.github.com/orgs/octocat",
                                                                                                              "id": 1,
                                                                                                              "repos_url": "https://api.github.com/users/octocat/repos",
                                                                                                              "events_url": "https://api.github.com/users/octocat/events{/privacy}",
                                                                                                              "members_url": "https://api.github.com/users/octocat/members{/member}",
                                                                                                              "public_members_url": "https://api.github/com/users/octocat/public_members{/member}",
                                                                                                              "avatar_url": "https://secure.gravatar.com/avatar/7ad39074b0584bc555d0417ae3e7d974?d=https://a248.e.akamai.net/assets.github.com%2Fimages%2Fgravatars%2Fgravatar-140.png"
                                                                                                            },
                                                                                                            "user": {
                                                                                                              "login": "defunkt",
                                                                                                              "id": 3,
                                                                                                              "avatar_url": "https://github.com/images/error/octocat_happy.gif",
                                                                                                              "gravatar_id": "",
                                                                                                              "url": "https://api.github.com/users/defunkt",
                                                                                                              "html_url": "https://github.com/defunkt",
                                                                                                              "followers_url": "https://api.github.com/users/defunkt/followers",
                                                                                                              "following_url": "https://api.github.com/users/defunkt/following{/other_user}",
                                                                                                              "gists_url": "https://api.github.com/users/defunkt/gists{/gist_id}",
                                                                                                              "starred_url": "https://api.github.com/users/defunkt/starred{/owner}{/repo}",
                                                                                                              "subscriptions_url": "https://api.github.com/users/defunkt/subscriptions",
                                                                                                              "organizations_url": "https://api.github.com/users/defunkt/orgs",
                                                                                                              "repos_url": "https://api.github.com/users/defunkt/repos",
                                                                                                              "events_url": "https://api.github.com/users/defunkt/events{/privacy}",
                                                                                                              "received_events_url": "https://api.github.com/users/defunkt/received_events",
                                                                                                              "type": "User",
                                                                                                              "site_admin": false
                                                                                                            }
                                                                                                          }
                                                                                                          
                                                                                                          tmp/developer.github.com/v3/orgs/outside_collaborators/index.html Organization Outside Collaborators | GitHub Developer Guide

                                                                                                          Outside Collaborators

                                                                                                          List outside collaborators

                                                                                                          List all users who are outside collaborators of an organization.

                                                                                                          GET /orgs/:org/outside_collaborators
                                                                                                          

                                                                                                          Parameters

                                                                                                          Name Type Description
                                                                                                          filter string Filter the list of outside collaborators. Can be one of:
                                                                                                          * 2fa_disabled: Outside collaborators without two-factor authentication enabled.
                                                                                                          * all: All outside collaborators.

                                                                                                          Default: all

                                                                                                          Response

                                                                                                          Status: 200 OK
                                                                                                          Link: <https://api.github.com/resource?page=2>; rel="next",
                                                                                                                <https://api.github.com/resource?page=5>; rel="last"
                                                                                                          
                                                                                                          [
                                                                                                            {
                                                                                                              "login": "octocat",
                                                                                                              "id": 1,
                                                                                                              "avatar_url": "https://github.com/images/error/octocat_happy.gif",
                                                                                                              "gravatar_id": "",
                                                                                                              "url": "https://api.github.com/users/octocat",
                                                                                                              "html_url": "https://github.com/octocat",
                                                                                                              "followers_url": "https://api.github.com/users/octocat/followers",
                                                                                                              "following_url": "https://api.github.com/users/octocat/following{/other_user}",
                                                                                                              "gists_url": "https://api.github.com/users/octocat/gists{/gist_id}",
                                                                                                              "starred_url": "https://api.github.com/users/octocat/starred{/owner}{/repo}",
                                                                                                              "subscriptions_url": "https://api.github.com/users/octocat/subscriptions",
                                                                                                              "organizations_url": "https://api.github.com/users/octocat/orgs",
                                                                                                              "repos_url": "https://api.github.com/users/octocat/repos",
                                                                                                              "events_url": "https://api.github.com/users/octocat/events{/privacy}",
                                                                                                              "received_events_url": "https://api.github.com/users/octocat/received_events",
                                                                                                              "type": "User",
                                                                                                              "site_admin": false
                                                                                                            }
                                                                                                          ]
                                                                                                          

                                                                                                          Remove outside collaborator

                                                                                                          Removing a user from this list will remove them from all the organization's repositories.

                                                                                                          DELETE /orgs/:org/outside_collaborators/:username
                                                                                                          

                                                                                                          Response

                                                                                                          Status: 204 No Content
                                                                                                          

                                                                                                          Response if user is a member of the organization

                                                                                                          Status: 422 Unprocessable Entity
                                                                                                          
                                                                                                          {
                                                                                                            "message": "You cannot specify an organization member to remove as an outside collaborator.",
                                                                                                            "documentation_url": "https://developer.github.com/v3/orgs/outside_collaborators/#remove-outside-collaborator"
                                                                                                          }
                                                                                                          

                                                                                                          Convert member to outside collaborator

                                                                                                          When an organization member is converted to an outside collaborator, they'll only have access to the repositories that their current team membership allows. The user will no longer be a member of the organization. For more information, see "Converting an organization member to an outside collaborator".

                                                                                                          PUT /orgs/:org/outside_collaborators/:username
                                                                                                          

                                                                                                          Response

                                                                                                          Status: 204 No Content
                                                                                                          

                                                                                                          Response if user is the last owner of the organization

                                                                                                          Status: 403 Forbidden
                                                                                                          
                                                                                                          {
                                                                                                            "message": "Cannot convert the last owner to an outside collaborator",
                                                                                                            "documentation_url": "https://developer.github.com/v3/orgs/outside_collaborators/#convert-member-to-outside-collaborator"
                                                                                                          }
                                                                                                          

                                                                                                          Response if user is not a member of the organization

                                                                                                          Status: 403 Forbidden
                                                                                                          
                                                                                                          {
                                                                                                            "message": "<user> is not a member of the <organization> organization.",
                                                                                                            "documentation_url": "https://developer.github.com/v3/orgs/outside_collaborators/#convert-member-to-outside-collaborator"
                                                                                                          }
                                                                                                          
                                                                                                          tmp/developer.github.com/v3/orgs/pre_receive_hooks/index.html Organization Pre-receive Hooks | GitHub Developer Guide

                                                                                                          Organization Pre-receive Hooks (Enterprise)

                                                                                                          APIs for managing pre-receive hooks are currently available for developers to preview. During the preview period, the APIs may change without advance notice.

                                                                                                          To access the API you must provide a custom media type in the Accept header:

                                                                                                            application/vnd.github.eye-scream-preview
                                                                                                          

                                                                                                          The Organization Pre-receive Hooks API allows you to view and modify enforcement of the pre-receive hooks that are available to an organization.

                                                                                                          Prefix all the endpoints for this API with the following URL:

                                                                                                          http(s)://hostname/api/v3
                                                                                                          

                                                                                                          Object attributes

                                                                                                          Name Type Description
                                                                                                          name string The name of the hook.
                                                                                                          enforcement string The state of enforcement for the hook on this repository.
                                                                                                          allow_downstream_configuration boolean Whether repositories can override enforcement.
                                                                                                          configuration_url string URL for the endpoint where enforcement is set.

                                                                                                          Possible values for enforcement are enabled, disabled andtesting. disabled indicates the pre-receive hook will not run. enabled indicates it will run and reject any pushes that result in a non-zero status. testing means the script will run but will not cause any pushes to be rejected.

                                                                                                          configuration_url may be a link to this endpoint or this hook's global configuration. Only site admins are able to access the global configuration.

                                                                                                          List pre-receive hooks

                                                                                                          List all pre-receive hooks that are enabled or testing for this organization as well as any disabled hooks that can be configured at the organization level. Globally disabled pre-receive hooks that do not allow downstream configuration are not listed.

                                                                                                          GET /orgs/:org/pre-receive-hooks
                                                                                                          
                                                                                                          Status: 200 OK
                                                                                                          Link: <https://api.github.com/resource?page=2>; rel="next",
                                                                                                                <https://api.github.com/resource?page=5>; rel="last"
                                                                                                          
                                                                                                          [
                                                                                                            {
                                                                                                              "id": 42,
                                                                                                              "name": "Check Commits",
                                                                                                              "enforcement": "disabled",
                                                                                                              "configuration_url": "https://github.example.com/api/v3/admin/pre-receive-hooks/42",
                                                                                                              "allow_downstream_configuration": true
                                                                                                            }
                                                                                                          ]
                                                                                                          

                                                                                                          Get a single pre-receive hook

                                                                                                          GET /orgs/:org:pre-receive-hooks/:id
                                                                                                          
                                                                                                          Status: 200 OK
                                                                                                          
                                                                                                          {
                                                                                                            "id": 42,
                                                                                                            "name": "Check Commits",
                                                                                                            "enforcement": "disabled",
                                                                                                            "configuration_url": "https://github.example.com/api/v3/admin/pre-receive-hooks/42",
                                                                                                            "allow_downstream_configuration": true
                                                                                                          }
                                                                                                          

                                                                                                          Update pre-receive hook enforcement

                                                                                                          For pre-receive hooks which are allowed to be configured at the org level, you can set enforcement and allow_downstream_configuration

                                                                                                          PATCH /orgs/:org/pre-receive-hooks/:id
                                                                                                          
                                                                                                          {
                                                                                                            "enforcement": "enabled",
                                                                                                            "allow_downstream_configuration": false
                                                                                                          }
                                                                                                          

                                                                                                          Response

                                                                                                          Status: 200 OK
                                                                                                          
                                                                                                          {
                                                                                                            "id": 42,
                                                                                                            "name": "Check Commits",
                                                                                                            "enforcement": "enabled",
                                                                                                            "configuration_url": "https://github.example.com/api/v3/orgs/octocat/pre-receive-hooks/42",
                                                                                                            "allow_downstream_configuration": false
                                                                                                          }
                                                                                                          

                                                                                                          Remove enforcment overrides for a pre-receive hook

                                                                                                          Removes any overrides for this hook at the org level for this org.

                                                                                                          DELETE /orgs/:org/pre-receive-hooks/:id
                                                                                                          
                                                                                                          Status: 200 OK
                                                                                                          
                                                                                                          {
                                                                                                            "id": 42,
                                                                                                            "name": "Check Commits",
                                                                                                            "enforcement": "disabled",
                                                                                                            "configuration_url": "https://github.example.com/api/v3/admin/pre-receive-hooks/42",
                                                                                                            "allow_downstream_configuration": true
                                                                                                          }
                                                                                                          
                                                                                                          tmp/developer.github.com/v3/orgs/teams/index.html Organization Teams | GitHub Developer Guide

                                                                                                          Teams

                                                                                                          All team actions must be performed by an authenticated user who belongs to the affected :org. Additionally, OAuth users require the read:org scope.

                                                                                                          Note: To help with migrating from our REST API v3 to GraphQL API v4, we're introducing a preview period to include the GraphQL node_id in the response for many REST API v3 resources. See the blog post for full details. To access node_id during the preview period, you must provide a custom media type in the Accept header:

                                                                                                          application/vnd.github.jean-grey-preview+json
                                                                                                          

                                                                                                          Warning: The API may change without advance notice during the preview period. Preview features are not supported for production use. If you experience any issues, contact GitHub support.

                                                                                                          List teams

                                                                                                          Note: The Nested Teams API is currently available for developers to preview. See the blog post for full details. To access the API, you must provide a custom media type in the Accept header:

                                                                                                          application/vnd.github.hellcat-preview+json
                                                                                                          

                                                                                                          Warning: The API may change without advance notice during the preview period. Preview features are not supported for production use. If you experience any issues, contact GitHub support.

                                                                                                          GET /orgs/:org/teams
                                                                                                          

                                                                                                          Response

                                                                                                          Status: 200 OK
                                                                                                          Link: <https://api.github.com/resource?page=2>; rel="next",
                                                                                                                <https://api.github.com/resource?page=5>; rel="last"
                                                                                                          
                                                                                                          [
                                                                                                            {
                                                                                                              "id": 1,
                                                                                                              "url": "https://api.github.com/teams/1",
                                                                                                              "name": "Justice League",
                                                                                                              "slug": "justice-league",
                                                                                                              "description": "A great team.",
                                                                                                              "privacy": "closed",
                                                                                                              "permission": "admin",
                                                                                                              "members_url": "https://api.github.com/teams/1/members{/member}",
                                                                                                              "repositories_url": "https://api.github.com/teams/1/repos",
                                                                                                              "parent": null
                                                                                                            }
                                                                                                          ]
                                                                                                          

                                                                                                          Get team

                                                                                                          Note: The Nested Teams API is currently available for developers to preview. See the blog post for full details. To access the API, you must provide a custom media type in the Accept header:

                                                                                                          application/vnd.github.hellcat-preview+json
                                                                                                          

                                                                                                          Warning: The API may change without advance notice during the preview period. Preview features are not supported for production use. If you experience any issues, contact GitHub support.

                                                                                                          GET /teams/:id
                                                                                                          

                                                                                                          Response

                                                                                                          Status: 200 OK
                                                                                                          Link: <https://api.github.com/resource?page=2>; rel="next",
                                                                                                                <https://api.github.com/resource?page=5>; rel="last"
                                                                                                          
                                                                                                          [
                                                                                                            {
                                                                                                              "id": 1,
                                                                                                              "url": "https://api.github.com/teams/1",
                                                                                                              "name": "Justice League",
                                                                                                              "slug": "justice-league",
                                                                                                              "description": "A great team.",
                                                                                                              "privacy": "closed",
                                                                                                              "permission": "admin",
                                                                                                              "members_url": "https://api.github.com/teams/1/members{/member}",
                                                                                                              "repositories_url": "https://api.github.com/teams/1/repos",
                                                                                                              "members_count": 3,
                                                                                                              "repos_count": 10,
                                                                                                              "created_at": "2017-07-14T16:53:42Z",
                                                                                                              "updated_at": "2017-08-17T12:37:15Z",
                                                                                                              "organization": {
                                                                                                                "login": "github",
                                                                                                                "id": 1,
                                                                                                                "url": "https://api.github.com/orgs/github",
                                                                                                                "repos_url": "https://api.github.com/orgs/github/repos",
                                                                                                                "events_url": "https://api.github.com/orgs/github/events",
                                                                                                                "hooks_url": "https://api.github.com/orgs/github/hooks",
                                                                                                                "issues_url": "https://api.github.com/orgs/github/issues",
                                                                                                                "members_url": "https://api.github.com/orgs/github/members{/member}",
                                                                                                                "public_members_url": "https://api.github.com/orgs/github/public_members{/member}",
                                                                                                                "avatar_url": "https://github.com/images/error/octocat_happy.gif",
                                                                                                                "description": "A great organization"
                                                                                                              },
                                                                                                              "parent": null
                                                                                                            }
                                                                                                          ]
                                                                                                          

                                                                                                          Create team

                                                                                                          Note: The Nested Teams API is currently available for developers to preview. See the blog post for full details. To access the API, you must provide a custom media type in the Accept header:

                                                                                                          application/vnd.github.hellcat-preview+json
                                                                                                          

                                                                                                          Warning: The API may change without advance notice during the preview period. Preview features are not supported for production use. If you experience any issues, contact GitHub support.

                                                                                                          To create a team, the authenticated user must be a member of :org.

                                                                                                          POST /orgs/:org/teams
                                                                                                          

                                                                                                          Parameters

                                                                                                          Name Type Description
                                                                                                          name string Required. The name of the team.
                                                                                                          description string The description of the team.
                                                                                                          maintainers array of strings The logins of organization members to add as maintainers of the team.
                                                                                                          repo_names array of strings The full name (e.g., "organization-name/repository-name") of repositories to add the team to.
                                                                                                          privacy string The level of privacy this team should have. The options are:
                                                                                                          For a non-nested team:
                                                                                                          * secret - only visible to organization owners and members of this team.
                                                                                                          * closed - visible to all members of this organization.
                                                                                                          Default: secret
                                                                                                          For a parent or child team:
                                                                                                          * closed - visible to all members of this organization.
                                                                                                          Default for child team: closed
                                                                                                          Note: You must pass the hellcat-preview media type to set privacy default to closed for child teams.
                                                                                                          permission string Deprecated. The permission that new repositories will be added to the team with when none is specified. Can be one of:
                                                                                                          * pull - team members can pull, but not push to or administer newly-added repositories.
                                                                                                          * push - team members can pull and push, but not administer newly-added repositories.
                                                                                                          * admin - team members can pull, push and administer newly-added repositories.
                                                                                                          Default: pull
                                                                                                          parent_team_id integer The ID of a team to set as the parent team. Note: You must pass the hellcat-preview media type to use this parameter.

                                                                                                          Response

                                                                                                          Status: 201 Created
                                                                                                          
                                                                                                          [
                                                                                                            {
                                                                                                              "id": 1,
                                                                                                              "url": "https://api.github.com/teams/1",
                                                                                                              "name": "Justice League",
                                                                                                              "slug": "justice-league",
                                                                                                              "description": "A great team.",
                                                                                                              "privacy": "closed",
                                                                                                              "permission": "admin",
                                                                                                              "members_url": "https://api.github.com/teams/1/members{/member}",
                                                                                                              "repositories_url": "https://api.github.com/teams/1/repos",
                                                                                                              "members_count": 3,
                                                                                                              "repos_count": 10,
                                                                                                              "created_at": "2017-07-14T16:53:42Z",
                                                                                                              "updated_at": "2017-08-17T12:37:15Z",
                                                                                                              "organization": {
                                                                                                                "login": "github",
                                                                                                                "id": 1,
                                                                                                                "url": "https://api.github.com/orgs/github",
                                                                                                                "repos_url": "https://api.github.com/orgs/github/repos",
                                                                                                                "events_url": "https://api.github.com/orgs/github/events",
                                                                                                                "hooks_url": "https://api.github.com/orgs/github/hooks",
                                                                                                                "issues_url": "https://api.github.com/orgs/github/issues",
                                                                                                                "members_url": "https://api.github.com/orgs/github/members{/member}",
                                                                                                                "public_members_url": "https://api.github.com/orgs/github/public_members{/member}",
                                                                                                                "avatar_url": "https://github.com/images/error/octocat_happy.gif",
                                                                                                                "description": "A great organization"
                                                                                                              },
                                                                                                              "parent": null
                                                                                                            }
                                                                                                          ]
                                                                                                          

                                                                                                          Edit team

                                                                                                          Note: The Nested Teams API is currently available for developers to preview. See the blog post for full details. To access the API, you must provide a custom media type in the Accept header:

                                                                                                          application/vnd.github.hellcat-preview+json
                                                                                                          

                                                                                                          Warning: The API may change without advance notice during the preview period. Preview features are not supported for production use. If you experience any issues, contact GitHub support.

                                                                                                          To edit a team, the authenticated user must either be an owner of the org that the team is associated with, or a maintainer of the team.

                                                                                                          PATCH /teams/:id
                                                                                                          

                                                                                                          Parameters

                                                                                                          Name Type Description
                                                                                                          name string Required. The name of the team.
                                                                                                          description string The description of the team.
                                                                                                          privacy string The level of privacy this team should have. Editing teams without specifying this parameter leaves privacy intact. The options are:
                                                                                                          For a non-nested team:
                                                                                                          * secret - only visible to organization owners and members of this team.
                                                                                                          * closed - visible to all members of this organization.
                                                                                                          For a parent or child team:
                                                                                                          * closed - visible to all members of this organization.

                                                                                                          permission string Deprecated. The permission that new repositories will be added to the team with when none is specified. Can be one of:
                                                                                                          * pull - team members can pull, but not push to or administer newly-added repositories.
                                                                                                          * push - team members can pull and push, but not administer newly-added repositories.
                                                                                                          * admin - team members can pull, push and administer newly-added repositories.
                                                                                                          Default: pull
                                                                                                          parent_team_id integer The ID of a team to set as the parent team. Note: You must pass the hellcat-preview media type to use this parameter.

                                                                                                          Note: With nested teams, the privacy for parent teams cannot be secret.

                                                                                                          Example

                                                                                                          {
                                                                                                            "name": "new team name",
                                                                                                            "description": "new team description",
                                                                                                            "privacy": "closed"
                                                                                                          }
                                                                                                          

                                                                                                          Response

                                                                                                          Status: 201 Created
                                                                                                          
                                                                                                          [
                                                                                                            {
                                                                                                              "id": 1,
                                                                                                              "url": "https://api.github.com/teams/1",
                                                                                                              "name": "Justice League",
                                                                                                              "slug": "justice-league",
                                                                                                              "description": "A great team.",
                                                                                                              "privacy": "closed",
                                                                                                              "permission": "admin",
                                                                                                              "members_url": "https://api.github.com/teams/1/members{/member}",
                                                                                                              "repositories_url": "https://api.github.com/teams/1/repos",
                                                                                                              "members_count": 3,
                                                                                                              "repos_count": 10,
                                                                                                              "created_at": "2017-07-14T16:53:42Z",
                                                                                                              "updated_at": "2017-08-17T12:37:15Z",
                                                                                                              "organization": {
                                                                                                                "login": "github",
                                                                                                                "id": 1,
                                                                                                                "url": "https://api.github.com/orgs/github",
                                                                                                                "repos_url": "https://api.github.com/orgs/github/repos",
                                                                                                                "events_url": "https://api.github.com/orgs/github/events",
                                                                                                                "hooks_url": "https://api.github.com/orgs/github/hooks",
                                                                                                                "issues_url": "https://api.github.com/orgs/github/issues",
                                                                                                                "members_url": "https://api.github.com/orgs/github/members{/member}",
                                                                                                                "public_members_url": "https://api.github.com/orgs/github/public_members{/member}",
                                                                                                                "avatar_url": "https://github.com/images/error/octocat_happy.gif",
                                                                                                                "description": "A great organization"
                                                                                                              },
                                                                                                              "parent": null
                                                                                                            }
                                                                                                          ]
                                                                                                          

                                                                                                          Delete team

                                                                                                          Note: The Nested Teams API is currently available for developers to preview. See the blog post for full details. To access the API, you must provide a custom media type in the Accept header:

                                                                                                          application/vnd.github.hellcat-preview+json
                                                                                                          

                                                                                                          Warning: The API may change without advance notice during the preview period. Preview features are not supported for production use. If you experience any issues, contact GitHub support.

                                                                                                          To delete a team, the authenticated user must be a team maintainer or an owner of the org associated with the team.

                                                                                                          If you are an organization owner and you pass the hellcat-preview media type, deleting a parent team will delete all of its child teams as well.

                                                                                                          DELETE /teams/:id
                                                                                                          

                                                                                                          Response

                                                                                                          Status: 204 No Content
                                                                                                          

                                                                                                          List child teams

                                                                                                          Note: The Nested Teams API is currently available for developers to preview. See the blog post for full details. To access the API, you must provide a custom media type in the Accept header:

                                                                                                          application/vnd.github.hellcat-preview+json
                                                                                                          

                                                                                                          Warning: The API may change without advance notice during the preview period. Preview features are not supported for production use. If you experience any issues, contact GitHub support.

                                                                                                          At this time, the hellcat-preview media type is required to use this endpoint.

                                                                                                          GET /teams/:id/teams
                                                                                                          

                                                                                                          Response if child teams exist

                                                                                                          Status: 200 OK
                                                                                                          Link: <https://api.github.com/resource?page=2>; rel="next",
                                                                                                                <https://api.github.com/resource?page=5>; rel="last"
                                                                                                          
                                                                                                          [
                                                                                                            {
                                                                                                              "id": 2,
                                                                                                              "url": "https://api.github.com/teams/2",
                                                                                                              "name": "Original Roster",
                                                                                                              "slug": "original-roster",
                                                                                                              "description": "Started it all.",
                                                                                                              "privacy": "closed",
                                                                                                              "permission": "admin",
                                                                                                              "members_url": "https://api.github.com/teams/2/members{/member}",
                                                                                                              "repositories_url": "https://api.github.com/teams/2/repos",
                                                                                                              "parent": {
                                                                                                                "id": 1,
                                                                                                                "url": "https://api.github.com/teams/1",
                                                                                                                "name": "Justice League",
                                                                                                                "slug": "justice-league",
                                                                                                                "description": "A great team.",
                                                                                                                "privacy": "closed",
                                                                                                                "permission": "admin",
                                                                                                                "members_url": "https://api.github.com/teams/1/members{/member}",
                                                                                                                "repositories_url": "https://api.github.com/teams/1/repos"
                                                                                                              }
                                                                                                            }
                                                                                                          ]
                                                                                                          

                                                                                                          Response if no child teams exist

                                                                                                          Status: 200 OK
                                                                                                          
                                                                                                          [
                                                                                                          
                                                                                                          ]
                                                                                                          

                                                                                                          List team members

                                                                                                          Note: The Nested Teams API is currently available for developers to preview. See the blog post for full details. To access the API, you must provide a custom media type in the Accept header:

                                                                                                          application/vnd.github.hellcat-preview+json
                                                                                                          

                                                                                                          Warning: The API may change without advance notice during the preview period. Preview features are not supported for production use. If you experience any issues, contact GitHub support.

                                                                                                          If you pass the hellcat-preview media type, team members will include the members of child teams.

                                                                                                          To list members in a team, the team must be visible to the authenticated user.

                                                                                                          GET /teams/:id/members
                                                                                                          
                                                                                                          Name Type Description
                                                                                                          role string Filters members returned by their role in the team. Can be one of:
                                                                                                          * member - normal members of the team.
                                                                                                          * maintainer - team maintainers.
                                                                                                          * all - all members of the team.
                                                                                                          Default: all

                                                                                                          Response

                                                                                                          Status: 200 OK
                                                                                                          Link: <https://api.github.com/resource?page=2>; rel="next",
                                                                                                                <https://api.github.com/resource?page=5>; rel="last"
                                                                                                          
                                                                                                          [
                                                                                                            {
                                                                                                              "login": "octocat",
                                                                                                              "id": 1,
                                                                                                              "avatar_url": "https://github.com/images/error/octocat_happy.gif",
                                                                                                              "gravatar_id": "",
                                                                                                              "url": "https://api.github.com/users/octocat",
                                                                                                              "html_url": "https://github.com/octocat",
                                                                                                              "followers_url": "https://api.github.com/users/octocat/followers",
                                                                                                              "following_url": "https://api.github.com/users/octocat/following{/other_user}",
                                                                                                              "gists_url": "https://api.github.com/users/octocat/gists{/gist_id}",
                                                                                                              "starred_url": "https://api.github.com/users/octocat/starred{/owner}{/repo}",
                                                                                                              "subscriptions_url": "https://api.github.com/users/octocat/subscriptions",
                                                                                                              "organizations_url": "https://api.github.com/users/octocat/orgs",
                                                                                                              "repos_url": "https://api.github.com/users/octocat/repos",
                                                                                                              "events_url": "https://api.github.com/users/octocat/events{/privacy}",
                                                                                                              "received_events_url": "https://api.github.com/users/octocat/received_events",
                                                                                                              "type": "User",
                                                                                                              "site_admin": false
                                                                                                            }
                                                                                                          ]
                                                                                                          

                                                                                                          Get team member

                                                                                                          Deprecation notice

                                                                                                          The "Get team member" API (described below) is deprecated.

                                                                                                          We recommend using the Get team membership API instead. It allows you to get both active and pending memberships.

                                                                                                          To list members in a team, the team must be visible to the authenticated user.

                                                                                                          GET /teams/:id/members/:username
                                                                                                          

                                                                                                          Response if user is a member

                                                                                                          Status: 204 No Content
                                                                                                          

                                                                                                          Response if user is not a member

                                                                                                          Status: 404 Not Found
                                                                                                          

                                                                                                          Add team member

                                                                                                          Deprecation notice

                                                                                                          The "Add team member" API (described below) is deprecated.

                                                                                                          We recommend using the Add team membership API instead. It allows you to invite new organization members to your teams.

                                                                                                          To add a user to a team, the authenticated user must have 'admin' permissions to the team or be an owner of the organization that the team is associated with, and the user being added must already be a member of at least one other team on the same organization.

                                                                                                          PUT /teams/:id/members/:username
                                                                                                          

                                                                                                          Note that you'll need to set Content-Length to zero when calling out to this endpoint. For more information, see "HTTP verbs."

                                                                                                          Response

                                                                                                          Status: 204 No Content
                                                                                                          

                                                                                                          If you attempt to add an organization to a team, you will get this:

                                                                                                          Status: 422 Unprocessable Entity
                                                                                                          
                                                                                                          {
                                                                                                            "message": "Cannot add an organization as a member.",
                                                                                                            "errors": [
                                                                                                              {
                                                                                                                "code": "org",
                                                                                                                "field": "user",
                                                                                                                "resource": "TeamMember"
                                                                                                              }
                                                                                                            ]
                                                                                                          }
                                                                                                          

                                                                                                          If you attempt to add a user to a team and that user is not a member of at least one other team on the same organization, you will get this:

                                                                                                          Status: 422 Unprocessable Entity
                                                                                                          
                                                                                                          {
                                                                                                            "message": "User isn't a member of this organization. Please invite them first.",
                                                                                                            "errors": [
                                                                                                              {
                                                                                                                "code": "unaffiliated",
                                                                                                                "field": "user",
                                                                                                                "resource": "TeamMember"
                                                                                                              }
                                                                                                            ]
                                                                                                          }
                                                                                                          

                                                                                                          Remove team member

                                                                                                          Deprecation notice

                                                                                                          The "Remove team member" API (described below) is deprecated.

                                                                                                          We recommend using the Remove team membership API instead. It allows you to remove both active and pending memberships.

                                                                                                          To remove a user from a team, the authenticated user must have 'admin' permissions to the team or be an owner of the org that the team is associated with. NOTE: This does not delete the user, it just removes them from the team.

                                                                                                          DELETE /teams/:id/members/:username
                                                                                                          

                                                                                                          Response

                                                                                                          Status: 204 No Content
                                                                                                          

                                                                                                          Get team membership

                                                                                                          Note: The Nested Teams API is currently available for developers to preview. See the blog post for full details. To access the API, you must provide a custom media type in the Accept header:

                                                                                                          application/vnd.github.hellcat-preview+json
                                                                                                          

                                                                                                          Warning: The API may change without advance notice during the preview period. Preview features are not supported for production use. If you experience any issues, contact GitHub support.

                                                                                                          If you pass the hellcat-preview media type, team members will include the members of child teams.

                                                                                                          To get a user's membership with a team, the team must be visible to the authenticated user.

                                                                                                          GET /teams/:id/memberships/:username
                                                                                                          

                                                                                                          Note: The role for organization owners returns as maintainer. For more information about maintainer roles, see Create team.

                                                                                                          Response if user has an active membership with team

                                                                                                          Status: 200 OK
                                                                                                          
                                                                                                          {
                                                                                                            "url": "https://api.github.com/teams/1/memberships/octocat",
                                                                                                            "role": "member",
                                                                                                            "state": "active"
                                                                                                          }
                                                                                                          

                                                                                                          Response if user is a team maintainer

                                                                                                          Status: 200 OK
                                                                                                          
                                                                                                          {
                                                                                                            "url": "https://api.github.com/teams/1/memberships/octocat",
                                                                                                            "role": "maintainer",
                                                                                                            "state": "active"
                                                                                                          }
                                                                                                          

                                                                                                          Response if user has a pending membership with team

                                                                                                          Status: 200 OK
                                                                                                          
                                                                                                          {
                                                                                                            "url": "https://api.github.com/teams/1/memberships/octocat",
                                                                                                            "role": "member",
                                                                                                            "state": "pending"
                                                                                                          }
                                                                                                          

                                                                                                          No membership response

                                                                                                          Status: 404 Not Found
                                                                                                          

                                                                                                          Add or update team membership

                                                                                                          If the user is already a member of the team's organization, this endpoint will add the user to the team. To add a membership between an organization member and a team, the authenticated user must be an organization owner or a maintainer of the team.

                                                                                                          If the user is unaffiliated with the team's organization, this endpoint will send an invitation to the user via email. This newly-created membership will be in the "pending" state until the user accepts the invitation, at which point the membership will transition to the "active" state and the user will be added as a member of the team. To add a membership between an unaffiliated user and a team, the authenticated user must be an organization owner.

                                                                                                          If the user is already a member of the team, this endpoint will update the role of the team member's role. To update the membership of a team member, the authenticated user must be an organization owner or a maintainer of the team.

                                                                                                          PUT /teams/:id/memberships/:username
                                                                                                          

                                                                                                          Parameters

                                                                                                          Name Type Description
                                                                                                          role string The role that this user should have in the team. Can be one of:
                                                                                                          * member - a normal member of the team.
                                                                                                          * maintainer - a team maintainer. Able to add/remove other team members, promote other team members to team maintainer, and edit the team's name and description.
                                                                                                          Default: member

                                                                                                          Response if user's membership with team is now active

                                                                                                          Status: 200 OK
                                                                                                          
                                                                                                          {
                                                                                                            "url": "https://api.github.com/teams/1/memberships/octocat",
                                                                                                            "role": "member",
                                                                                                            "state": "active"
                                                                                                          }
                                                                                                          

                                                                                                          Response if user's membership with team is now pending

                                                                                                          Status: 200 OK
                                                                                                          
                                                                                                          {
                                                                                                            "url": "https://api.github.com/teams/1/memberships/octocat",
                                                                                                            "role": "member",
                                                                                                            "state": "pending"
                                                                                                          }
                                                                                                          

                                                                                                          If you attempt to add an organization to a team, you will get this:

                                                                                                          Status: 422 Unprocessable Entity
                                                                                                          
                                                                                                          {
                                                                                                            "message": "Cannot add an organization as a member.",
                                                                                                            "errors": [
                                                                                                              {
                                                                                                                "code": "org",
                                                                                                                "field": "user",
                                                                                                                "resource": "TeamMember"
                                                                                                              }
                                                                                                            ]
                                                                                                          }
                                                                                                          

                                                                                                          Remove team membership

                                                                                                          To remove a membership between a user and a team, the authenticated user must have 'admin' permissions to the team or be an owner of the organization that the team is associated with. NOTE: This does not delete the user, it just removes their membership from the team.

                                                                                                          DELETE /teams/:id/memberships/:username
                                                                                                          

                                                                                                          Response

                                                                                                          Status: 204 No Content
                                                                                                          

                                                                                                          List team repos

                                                                                                          Note: The Nested Teams API is currently available for developers to preview. See the blog post for full details. To access the API, you must provide a custom media type in the Accept header:

                                                                                                          application/vnd.github.hellcat-preview+json
                                                                                                          

                                                                                                          Warning: The API may change without advance notice during the preview period. Preview features are not supported for production use. If you experience any issues, contact GitHub support.

                                                                                                          Note: If you pass the hellcat-preview media type, the response will include any repositories inherited through a parent team.

                                                                                                          GET /teams/:id/repos
                                                                                                          

                                                                                                          Response

                                                                                                          Status: 200 OK
                                                                                                          Link: <https://api.github.com/resource?page=2>; rel="next",
                                                                                                                <https://api.github.com/resource?page=5>; rel="last"
                                                                                                          
                                                                                                          [
                                                                                                            {
                                                                                                              "id": 1296269,
                                                                                                              "owner": {
                                                                                                                "login": "octocat",
                                                                                                                "id": 1,
                                                                                                                "avatar_url": "https://github.com/images/error/octocat_happy.gif",
                                                                                                                "gravatar_id": "",
                                                                                                                "url": "https://api.github.com/users/octocat",
                                                                                                                "html_url": "https://github.com/octocat",
                                                                                                                "followers_url": "https://api.github.com/users/octocat/followers",
                                                                                                                "following_url": "https://api.github.com/users/octocat/following{/other_user}",
                                                                                                                "gists_url": "https://api.github.com/users/octocat/gists{/gist_id}",
                                                                                                                "starred_url": "https://api.github.com/users/octocat/starred{/owner}{/repo}",
                                                                                                                "subscriptions_url": "https://api.github.com/users/octocat/subscriptions",
                                                                                                                "organizations_url": "https://api.github.com/users/octocat/orgs",
                                                                                                                "repos_url": "https://api.github.com/users/octocat/repos",
                                                                                                                "events_url": "https://api.github.com/users/octocat/events{/privacy}",
                                                                                                                "received_events_url": "https://api.github.com/users/octocat/received_events",
                                                                                                                "type": "User",
                                                                                                                "site_admin": false
                                                                                                              },
                                                                                                              "name": "Hello-World",
                                                                                                              "full_name": "octocat/Hello-World",
                                                                                                              "description": "This your first repo!",
                                                                                                              "private": false,
                                                                                                              "fork": false,
                                                                                                              "url": "https://api.github.com/repos/octocat/Hello-World",
                                                                                                              "html_url": "https://github.com/octocat/Hello-World",
                                                                                                              "archive_url": "http://api.github.com/repos/octocat/Hello-World/{archive_format}{/ref}",
                                                                                                              "assignees_url": "http://api.github.com/repos/octocat/Hello-World/assignees{/user}",
                                                                                                              "blobs_url": "http://api.github.com/repos/octocat/Hello-World/git/blobs{/sha}",
                                                                                                              "branches_url": "http://api.github.com/repos/octocat/Hello-World/branches{/branch}",
                                                                                                              "clone_url": "https://github.com/octocat/Hello-World.git",
                                                                                                              "collaborators_url": "http://api.github.com/repos/octocat/Hello-World/collaborators{/collaborator}",
                                                                                                              "comments_url": "http://api.github.com/repos/octocat/Hello-World/comments{/number}",
                                                                                                              "commits_url": "http://api.github.com/repos/octocat/Hello-World/commits{/sha}",
                                                                                                              "compare_url": "http://api.github.com/repos/octocat/Hello-World/compare/{base}...{head}",
                                                                                                              "contents_url": "http://api.github.com/repos/octocat/Hello-World/contents/{+path}",
                                                                                                              "contributors_url": "http://api.github.com/repos/octocat/Hello-World/contributors",
                                                                                                              "deployments_url": "http://api.github.com/repos/octocat/Hello-World/deployments",
                                                                                                              "downloads_url": "http://api.github.com/repos/octocat/Hello-World/downloads",
                                                                                                              "events_url": "http://api.github.com/repos/octocat/Hello-World/events",
                                                                                                              "forks_url": "http://api.github.com/repos/octocat/Hello-World/forks",
                                                                                                              "git_commits_url": "http://api.github.com/repos/octocat/Hello-World/git/commits{/sha}",
                                                                                                              "git_refs_url": "http://api.github.com/repos/octocat/Hello-World/git/refs{/sha}",
                                                                                                              "git_tags_url": "http://api.github.com/repos/octocat/Hello-World/git/tags{/sha}",
                                                                                                              "git_url": "git:github.com/octocat/Hello-World.git",
                                                                                                              "hooks_url": "http://api.github.com/repos/octocat/Hello-World/hooks",
                                                                                                              "issue_comment_url": "http://api.github.com/repos/octocat/Hello-World/issues/comments{/number}",
                                                                                                              "issue_events_url": "http://api.github.com/repos/octocat/Hello-World/issues/events{/number}",
                                                                                                              "issues_url": "http://api.github.com/repos/octocat/Hello-World/issues{/number}",
                                                                                                              "keys_url": "http://api.github.com/repos/octocat/Hello-World/keys{/key_id}",
                                                                                                              "labels_url": "http://api.github.com/repos/octocat/Hello-World/labels{/name}",
                                                                                                              "languages_url": "http://api.github.com/repos/octocat/Hello-World/languages",
                                                                                                              "merges_url": "http://api.github.com/repos/octocat/Hello-World/merges",
                                                                                                              "milestones_url": "http://api.github.com/repos/octocat/Hello-World/milestones{/number}",
                                                                                                              "mirror_url": "git:git.example.com/octocat/Hello-World",
                                                                                                              "notifications_url": "http://api.github.com/repos/octocat/Hello-World/notifications{?since,all,participating}",
                                                                                                              "pulls_url": "http://api.github.com/repos/octocat/Hello-World/pulls{/number}",
                                                                                                              "releases_url": "http://api.github.com/repos/octocat/Hello-World/releases{/id}",
                                                                                                              "ssh_url": "git@github.com:octocat/Hello-World.git",
                                                                                                              "stargazers_url": "http://api.github.com/repos/octocat/Hello-World/stargazers",
                                                                                                              "statuses_url": "http://api.github.com/repos/octocat/Hello-World/statuses/{sha}",
                                                                                                              "subscribers_url": "http://api.github.com/repos/octocat/Hello-World/subscribers",
                                                                                                              "subscription_url": "http://api.github.com/repos/octocat/Hello-World/subscription",
                                                                                                              "svn_url": "https://svn.github.com/octocat/Hello-World",
                                                                                                              "tags_url": "http://api.github.com/repos/octocat/Hello-World/tags",
                                                                                                              "teams_url": "http://api.github.com/repos/octocat/Hello-World/teams",
                                                                                                              "trees_url": "http://api.github.com/repos/octocat/Hello-World/git/trees{/sha}",
                                                                                                              "homepage": "https://github.com",
                                                                                                              "language": null,
                                                                                                              "forks_count": 9,
                                                                                                              "stargazers_count": 80,
                                                                                                              "watchers_count": 80,
                                                                                                              "size": 108,
                                                                                                              "default_branch": "master",
                                                                                                              "open_issues_count": 0,
                                                                                                              "topics": [
                                                                                                                "octocat",
                                                                                                                "atom",
                                                                                                                "electron",
                                                                                                                "API"
                                                                                                              ],
                                                                                                              "has_issues": true,
                                                                                                              "has_wiki": true,
                                                                                                              "has_pages": false,
                                                                                                              "has_downloads": true,
                                                                                                              "archived": false,
                                                                                                              "pushed_at": "2011-01-26T19:06:43Z",
                                                                                                              "created_at": "2011-01-26T19:01:12Z",
                                                                                                              "updated_at": "2011-01-26T19:14:43Z",
                                                                                                              "permissions": {
                                                                                                                "admin": false,
                                                                                                                "push": false,
                                                                                                                "pull": true
                                                                                                              },
                                                                                                              "allow_rebase_merge": true,
                                                                                                              "allow_squash_merge": true,
                                                                                                              "allow_merge_commit": true,
                                                                                                              "subscribers_count": 42,
                                                                                                              "network_count": 0,
                                                                                                              "license": {
                                                                                                                "key": "mit",
                                                                                                                "name": "MIT License",
                                                                                                                "spdx_id": "MIT",
                                                                                                                "url": "https://api.github.com/licenses/mit",
                                                                                                                "html_url": "http://choosealicense.com/licenses/mit/"
                                                                                                              }
                                                                                                            }
                                                                                                          ]
                                                                                                          

                                                                                                          List pending team invitations

                                                                                                          Note: You can now use the API to invite users to a GitHub organization. This feature is currently available for developers to preview. See the blog post for full details. To access this feature, you must provide a custom media type in the Accept header:

                                                                                                          application/vnd.github.dazzler-preview+json
                                                                                                          

                                                                                                          Warning: The API may change without advance notice during the preview period. Preview features are not supported for production use. If you experience any issues, contact GitHub support.

                                                                                                          The return hash contains a role field which refers to the Organization Invitation role and will be one of the following values: direct_member, admin, billing_manager, hiring_manager, or reinstate. If the invitee is not a GitHub member, the login field in the return hash will be null.

                                                                                                          GET /teams/:id/invitations
                                                                                                          

                                                                                                          Response

                                                                                                          Status: 200 OK
                                                                                                          Link: <https://api.github.com/resource?page=2>; rel="next",
                                                                                                                <https://api.github.com/resource?page=5>; rel="last"
                                                                                                          
                                                                                                          [
                                                                                                            {
                                                                                                              "id": 1,
                                                                                                              "login": "monalisa",
                                                                                                              "email": "octocat@github.com",
                                                                                                              "role": "direct_member",
                                                                                                              "created_at": "2016-11-30T06:46:10-08:00",
                                                                                                              "inviter": {
                                                                                                                "login": "other_user",
                                                                                                                "id": 1,
                                                                                                                "avatar_url": "https://github.com/images/error/other_user_happy.gif",
                                                                                                                "gravatar_id": "",
                                                                                                                "url": "https://api.github.com/users/other_user",
                                                                                                                "html_url": "https://github.com/other_user",
                                                                                                                "followers_url": "https://api.github.com/users/other_user/followers",
                                                                                                                "following_url": "https://api.github.com/users/other_user/following{/other_user}",
                                                                                                                "gists_url": "https://api.github.com/users/other_user/gists{/gist_id}",
                                                                                                                "starred_url": "https://api.github.com/users/other_user/starred{/owner}{/repo}",
                                                                                                                "subscriptions_url": "https://api.github.com/users/other_user/subscriptions",
                                                                                                                "organizations_url": "https://api.github.com/users/other_user/orgs",
                                                                                                                "repos_url": "https://api.github.com/users/other_user/repos",
                                                                                                                "events_url": "https://api.github.com/users/other_user/events{/privacy}",
                                                                                                                "received_events_url": "https://api.github.com/users/other_user/received_events",
                                                                                                                "type": "User",
                                                                                                                "site_admin": false
                                                                                                              },
                                                                                                              "team_count": 2,
                                                                                                              "invitation_team_url": "https://api.github.com/organizations/2/invitations/1/teams"
                                                                                                            }
                                                                                                          ]
                                                                                                          

                                                                                                          Check if a team manages a repository

                                                                                                          Note: The Nested Teams API is currently available for developers to preview. See the blog post for full details. To access the API, you must provide a custom media type in the Accept header:

                                                                                                          application/vnd.github.hellcat-preview+json
                                                                                                          

                                                                                                          Warning: The API may change without advance notice during the preview period. Preview features are not supported for production use. If you experience any issues, contact GitHub support.

                                                                                                          Note: If you pass the hellcat-preview media type, repositories inherited through a parent team will be checked as well.

                                                                                                          GET /teams/:id/repos/:owner/:repo
                                                                                                          

                                                                                                          Response if repository is managed by this team

                                                                                                          Status: 204 No Content
                                                                                                          

                                                                                                          Response if repository is not managed by this team

                                                                                                          Status: 404 Not Found
                                                                                                          

                                                                                                          Alternative response with extra repository information

                                                                                                          You can also get information about the specified repository, including what permissions the team grants on it, by passing the following custom media type via the Accept header:

                                                                                                          Accept: application/vnd.github.v3.repository+json
                                                                                                          
                                                                                                          Status: 200 OK
                                                                                                          
                                                                                                          {
                                                                                                            "id": 1296269,
                                                                                                            "owner": {
                                                                                                              "login": "octocat",
                                                                                                              "id": 1,
                                                                                                              "avatar_url": "https://github.com/images/error/octocat_happy.gif",
                                                                                                              "gravatar_id": "",
                                                                                                              "url": "https://api.github.com/users/octocat",
                                                                                                              "html_url": "https://github.com/octocat",
                                                                                                              "followers_url": "https://api.github.com/users/octocat/followers",
                                                                                                              "following_url": "https://api.github.com/users/octocat/following{/other_user}",
                                                                                                              "gists_url": "https://api.github.com/users/octocat/gists{/gist_id}",
                                                                                                              "starred_url": "https://api.github.com/users/octocat/starred{/owner}{/repo}",
                                                                                                              "subscriptions_url": "https://api.github.com/users/octocat/subscriptions",
                                                                                                              "organizations_url": "https://api.github.com/users/octocat/orgs",
                                                                                                              "repos_url": "https://api.github.com/users/octocat/repos",
                                                                                                              "events_url": "https://api.github.com/users/octocat/events{/privacy}",
                                                                                                              "received_events_url": "https://api.github.com/users/octocat/received_events",
                                                                                                              "type": "User",
                                                                                                              "site_admin": false
                                                                                                            },
                                                                                                            "name": "Hello-World",
                                                                                                            "full_name": "octocat/Hello-World",
                                                                                                            "description": "This your first repo!",
                                                                                                            "private": false,
                                                                                                            "fork": false,
                                                                                                            "url": "https://api.github.com/repos/octocat/Hello-World",
                                                                                                            "html_url": "https://github.com/octocat/Hello-World",
                                                                                                            "archive_url": "http://api.github.com/repos/octocat/Hello-World/{archive_format}{/ref}",
                                                                                                            "assignees_url": "http://api.github.com/repos/octocat/Hello-World/assignees{/user}",
                                                                                                            "blobs_url": "http://api.github.com/repos/octocat/Hello-World/git/blobs{/sha}",
                                                                                                            "branches_url": "http://api.github.com/repos/octocat/Hello-World/branches{/branch}",
                                                                                                            "clone_url": "https://github.com/octocat/Hello-World.git",
                                                                                                            "collaborators_url": "http://api.github.com/repos/octocat/Hello-World/collaborators{/collaborator}",
                                                                                                            "comments_url": "http://api.github.com/repos/octocat/Hello-World/comments{/number}",
                                                                                                            "commits_url": "http://api.github.com/repos/octocat/Hello-World/commits{/sha}",
                                                                                                            "compare_url": "http://api.github.com/repos/octocat/Hello-World/compare/{base}...{head}",
                                                                                                            "contents_url": "http://api.github.com/repos/octocat/Hello-World/contents/{+path}",
                                                                                                            "contributors_url": "http://api.github.com/repos/octocat/Hello-World/contributors",
                                                                                                            "deployments_url": "http://api.github.com/repos/octocat/Hello-World/deployments",
                                                                                                            "downloads_url": "http://api.github.com/repos/octocat/Hello-World/downloads",
                                                                                                            "events_url": "http://api.github.com/repos/octocat/Hello-World/events",
                                                                                                            "forks_url": "http://api.github.com/repos/octocat/Hello-World/forks",
                                                                                                            "git_commits_url": "http://api.github.com/repos/octocat/Hello-World/git/commits{/sha}",
                                                                                                            "git_refs_url": "http://api.github.com/repos/octocat/Hello-World/git/refs{/sha}",
                                                                                                            "git_tags_url": "http://api.github.com/repos/octocat/Hello-World/git/tags{/sha}",
                                                                                                            "git_url": "git:github.com/octocat/Hello-World.git",
                                                                                                            "hooks_url": "http://api.github.com/repos/octocat/Hello-World/hooks",
                                                                                                            "issue_comment_url": "http://api.github.com/repos/octocat/Hello-World/issues/comments{/number}",
                                                                                                            "issue_events_url": "http://api.github.com/repos/octocat/Hello-World/issues/events{/number}",
                                                                                                            "issues_url": "http://api.github.com/repos/octocat/Hello-World/issues{/number}",
                                                                                                            "keys_url": "http://api.github.com/repos/octocat/Hello-World/keys{/key_id}",
                                                                                                            "labels_url": "http://api.github.com/repos/octocat/Hello-World/labels{/name}",
                                                                                                            "languages_url": "http://api.github.com/repos/octocat/Hello-World/languages",
                                                                                                            "merges_url": "http://api.github.com/repos/octocat/Hello-World/merges",
                                                                                                            "milestones_url": "http://api.github.com/repos/octocat/Hello-World/milestones{/number}",
                                                                                                            "mirror_url": "git:git.example.com/octocat/Hello-World",
                                                                                                            "notifications_url": "http://api.github.com/repos/octocat/Hello-World/notifications{?since,all,participating}",
                                                                                                            "pulls_url": "http://api.github.com/repos/octocat/Hello-World/pulls{/number}",
                                                                                                            "releases_url": "http://api.github.com/repos/octocat/Hello-World/releases{/id}",
                                                                                                            "ssh_url": "git@github.com:octocat/Hello-World.git",
                                                                                                            "stargazers_url": "http://api.github.com/repos/octocat/Hello-World/stargazers",
                                                                                                            "statuses_url": "http://api.github.com/repos/octocat/Hello-World/statuses/{sha}",
                                                                                                            "subscribers_url": "http://api.github.com/repos/octocat/Hello-World/subscribers",
                                                                                                            "subscription_url": "http://api.github.com/repos/octocat/Hello-World/subscription",
                                                                                                            "svn_url": "https://svn.github.com/octocat/Hello-World",
                                                                                                            "tags_url": "http://api.github.com/repos/octocat/Hello-World/tags",
                                                                                                            "teams_url": "http://api.github.com/repos/octocat/Hello-World/teams",
                                                                                                            "trees_url": "http://api.github.com/repos/octocat/Hello-World/git/trees{/sha}",
                                                                                                            "homepage": "https://github.com",
                                                                                                            "language": null,
                                                                                                            "forks_count": 9,
                                                                                                            "stargazers_count": 80,
                                                                                                            "watchers_count": 80,
                                                                                                            "size": 108,
                                                                                                            "default_branch": "master",
                                                                                                            "open_issues_count": 0,
                                                                                                            "topics": [
                                                                                                              "octocat",
                                                                                                              "atom",
                                                                                                              "electron",
                                                                                                              "API"
                                                                                                            ],
                                                                                                            "has_issues": true,
                                                                                                            "has_wiki": true,
                                                                                                            "has_pages": false,
                                                                                                            "has_downloads": true,
                                                                                                            "archived": false,
                                                                                                            "pushed_at": "2011-01-26T19:06:43Z",
                                                                                                            "created_at": "2011-01-26T19:01:12Z",
                                                                                                            "updated_at": "2011-01-26T19:14:43Z",
                                                                                                            "permissions": {
                                                                                                              "admin": false,
                                                                                                              "push": false,
                                                                                                              "pull": true
                                                                                                            },
                                                                                                            "allow_rebase_merge": true,
                                                                                                            "allow_squash_merge": true,
                                                                                                            "allow_merge_commit": true,
                                                                                                            "subscribers_count": 42,
                                                                                                            "network_count": 0
                                                                                                          }
                                                                                                          

                                                                                                          Add or update team repository

                                                                                                          Note: The Nested Teams API is currently available for developers to preview. See the blog post for full details. To access the API, you must provide a custom media type in the Accept header:

                                                                                                          application/vnd.github.hellcat-preview+json
                                                                                                          

                                                                                                          Warning: The API may change without advance notice during the preview period. Preview features are not supported for production use. If you experience any issues, contact GitHub support.

                                                                                                          To add a repository to a team or update the team's permission on a repository, the authenticated user must have admin access to the repository, and must be able to see the team. Also, the repository must be owned by the organization, or a direct fork of a repository owned by the organization.

                                                                                                          PUT /teams/:id/repos/:org/:repo
                                                                                                          

                                                                                                          Parameters

                                                                                                          Name Type Description
                                                                                                          permission string The permission to grant the team on this repository. Can be one of:
                                                                                                          * pull - team members can pull, but not push to or administer this repository.
                                                                                                          * push - team members can pull and push, but not administer this repository.
                                                                                                          * admin - team members can pull, push and administer this repository.

                                                                                                          If no permission is specified, the team's permission attribute will be used to determine what permission to grant the team on this repository.
                                                                                                          Note: If you pass the hellcat-preview media type, you can promote—but not demote—a permission attribute inherited through a parent team.

                                                                                                          Note that, if you choose not to pass any parameters, you'll need to set Content-Length to zero when calling out to this endpoint. For more information, see "HTTP verbs."

                                                                                                          Response

                                                                                                          Status: 204 No Content
                                                                                                          

                                                                                                          Response if you attempt to add a repository to a team that is not owned by the organization

                                                                                                          Status: 422 Unprocessable Entity
                                                                                                          
                                                                                                          {
                                                                                                            "message": "Validation Failed",
                                                                                                            "errors": [
                                                                                                              {
                                                                                                                "resource": "TeamRepository",
                                                                                                                "code": "unprocessable",
                                                                                                                "field": "data",
                                                                                                                "message": "not_owned"
                                                                                                              }
                                                                                                            ],
                                                                                                            "documentation_url": "https://developer.github.com/v3/orgs/teams/#add-team-repo"
                                                                                                          }
                                                                                                          

                                                                                                          Remove team repository

                                                                                                          If the authenticated user is an organization owner or a team maintainer, they can remove any repositories from the team. To remove a repository from a team as an organization member, the authenticated user must have admin access to the repository and must be able to see the team. NOTE: This does not delete the repository, it just removes it from the team.

                                                                                                          DELETE /teams/:id/repos/:owner/:repo
                                                                                                          

                                                                                                          Response

                                                                                                          Status: 204 No Content
                                                                                                          

                                                                                                          List user teams

                                                                                                          Note: The Nested Teams API is currently available for developers to preview. See the blog post for full details. To access the API, you must provide a custom media type in the Accept header:

                                                                                                          application/vnd.github.hellcat-preview+json
                                                                                                          

                                                                                                          Warning: The API may change without advance notice during the preview period. Preview features are not supported for production use. If you experience any issues, contact GitHub support.

                                                                                                          List all of the teams across all of the organizations to which the authenticated user belongs. This method requires user, repo, or read:org scope when authenticating via OAuth.

                                                                                                          GET /user/teams
                                                                                                          

                                                                                                          Response

                                                                                                          Status: 200 OK
                                                                                                          Link: <https://api.github.com/resource?page=2>; rel="next",
                                                                                                                <https://api.github.com/resource?page=5>; rel="last"
                                                                                                          
                                                                                                          [
                                                                                                            {
                                                                                                              "id": 1,
                                                                                                              "url": "https://api.github.com/teams/1",
                                                                                                              "name": "Justice League",
                                                                                                              "slug": "justice-league",
                                                                                                              "description": "A great team.",
                                                                                                              "privacy": "closed",
                                                                                                              "permission": "admin",
                                                                                                              "members_url": "https://api.github.com/teams/1/members{/member}",
                                                                                                              "repositories_url": "https://api.github.com/teams/1/repos",
                                                                                                              "members_count": 3,
                                                                                                              "repos_count": 10,
                                                                                                              "created_at": "2017-07-14T16:53:42Z",
                                                                                                              "updated_at": "2017-08-17T12:37:15Z",
                                                                                                              "organization": {
                                                                                                                "login": "github",
                                                                                                                "id": 1,
                                                                                                                "url": "https://api.github.com/orgs/github",
                                                                                                                "repos_url": "https://api.github.com/orgs/github/repos",
                                                                                                                "events_url": "https://api.github.com/orgs/github/events",
                                                                                                                "hooks_url": "https://api.github.com/orgs/github/hooks",
                                                                                                                "issues_url": "https://api.github.com/orgs/github/issues",
                                                                                                                "members_url": "https://api.github.com/orgs/github/members{/member}",
                                                                                                                "public_members_url": "https://api.github.com/orgs/github/public_members{/member}",
                                                                                                                "avatar_url": "https://github.com/images/error/octocat_happy.gif",
                                                                                                                "description": "A great organization"
                                                                                                              },
                                                                                                              "parent": null
                                                                                                            }
                                                                                                          ]
                                                                                                          
                                                                                                          tmp/developer.github.com/v3/pre-release/index.html Pre-release Program | GitHub Developer Guide

                                                                                                          The Pre-release Program

                                                                                                          Pre-release launches allow you to begin applying new features and functionality to your workflows before they're officially launched. As we polish the project, your feedback will ensure the implementation works for as many use cases as possible when the project moves to general release.

                                                                                                          Pre-releases are ready to be used to build real solutions that can be shared with your users in a pre-release setting, but they should not be used in full production situations. While we're confident in the direction of the project, there is a chance for announced breaking changes as we respond to feedback.

                                                                                                          What to expect

                                                                                                          • We will provide a communication channel to provide feedback on how the project applies to and impacts your use case.
                                                                                                          • We will keep you informed as we assess and incorporate your feedback, and we'll strive to prioritize issues that may be blocking you.
                                                                                                          • We will consistently update documentation and provide at least 72 hours advanced notice of breaking changes (except in rare, urgent circumstances).
                                                                                                          • You will experience a secure, reliable, and stable solution with low potential for bugs.
                                                                                                          • We will provide GitHub's standard high-quality support as you apply the implementation to your workflows.

                                                                                                          Getting started

                                                                                                          In order to use any Pre-release program, you must accept the pre-release agreement for your user and/or organization. Once you've accepted the agreement, you'll have access to our Platform Pre-release programs.

                                                                                                          All Pre-releases are listed on the GitHub Platform Roadmap, you can check there to see when we expect a Pre-release to move to full general release.

                                                                                                          Providing feedback

                                                                                                          We run the GitHub Platform Forum at platform.github.community. You'll be able to collaborate with other integrators, as well as engineers and product managers from GitHub. To foster transparency and collaboration, the GitHub Platform Forum should be used for all discussions, bug reports, and requests. If you need to discuss a private concern, you can contact GitHub support for assistance.

                                                                                                          Current programs

                                                                                                          Currently, we don't have any Pre-release programs available. We may have earlier stage releases available through our Early Access program.

                                                                                                          tmp/developer.github.com/v3/previews/index.html API previews | GitHub Developer Guide

                                                                                                          API Previews

                                                                                                          API previews let you try out new APIs and changes to existing API methods before they become part of the official GitHub API.

                                                                                                          During the preview period, we may change some features based on developer feedback. If we do make changes, we'll announce them on the developer blog without advance notice.

                                                                                                          To access an API preview, you'll need to provide a custom media type in the Accept header for your requests. Feature documentation for each preview specifies which custom media type to provide.

                                                                                                          Migrations

                                                                                                          Prepare a GitHub repository for migration to GitHub Enterprise.

                                                                                                          Custom media type: wyandotte-preview

                                                                                                          Source import

                                                                                                          Import source repositories to GitHub with the API version of the GitHub Importer.

                                                                                                          Custom media type: barred-rock-preview Announced: 2016-02-19 Update: 2016-05-03

                                                                                                          Enhanced deployments

                                                                                                          Exercise greater control over deployments with more information and finer granularity.

                                                                                                          Custom media type: ant-man-preview Announced: 2016-04-06

                                                                                                          Reactions

                                                                                                          Manage reactions for commits, issues, and comments.

                                                                                                          Custom media type: squirrel-girl-preview Announced: 2016-05-12 Update: 2016-06-07

                                                                                                          Timeline

                                                                                                          Get a list of events for an issue or pull request.

                                                                                                          Custom media type: mockingbird-preview Announced: 2016-05-23

                                                                                                          Pages

                                                                                                          Get more information about your GitHub Pages site.

                                                                                                          Custom media type: mister-fantastic-preview Announced: 2016-07-06

                                                                                                          Integrations

                                                                                                          Manage integrations through the API.

                                                                                                          Custom media type: machine-man-preview Announced: 2016-09-14

                                                                                                          Projects

                                                                                                          Manage projects.

                                                                                                          Custom media type: inertia-preview Announced: 2016-09-14 Update: 2016-10-27

                                                                                                          Commit search

                                                                                                          Search commits.

                                                                                                          Custom media type: cloak-preview Announced: 2017-01-05

                                                                                                          Community profile metrics

                                                                                                          Retrieve community profile metrics (also known as community health) for any public repository.

                                                                                                          Custom media type: black-panther-preview Announced: 2017-02-09

                                                                                                          User blocking

                                                                                                          Users can block other users. Organizations can block users, too.

                                                                                                          Custom media type: giant-sentry-fist-preview Announced: 2011-05-31 Update 1: 2016-04-04 Update 2: 2016-08-17

                                                                                                          SCIM

                                                                                                          SCIM-enabled Identity Providers (IdPs) can automate provisioning of GitHub organization membership.

                                                                                                          Custom media type: cloud-9-preview

                                                                                                          Repository topics

                                                                                                          View a list of repository topics in calls that return repository results.

                                                                                                          Custom media type: mercy-preview Announced: 2017-01-31

                                                                                                          Codes of conduct

                                                                                                          View all codes of conduct or get which code of conduct a repository has currently.

                                                                                                          Custom media type: scarlet-witch-preview

                                                                                                          Nested teams

                                                                                                          Include nested team content in team payloads.

                                                                                                          Custom media type: hellcat-preview Announced: 2017-09-01

                                                                                                          Repository transfer

                                                                                                          Transfer a repository to an organization or user.

                                                                                                          Custom media type: nightshade-preview Announced: 2017-11-09

                                                                                                          Global webhooks

                                                                                                          Enables global webhooks for organization and user event types. This API preview is only available for GitHub Enterprise.

                                                                                                          Custom media type: superpro-preview Announced: 2017-12-12

                                                                                                          GraphQL Global Relay IDs

                                                                                                          Get the node_id of a resource in the REST API v3 that corresponds to the ID of the same resource in the GraphQL API v4.

                                                                                                          Custom media type: jean-grey-preview Announced: 2017-12-19

                                                                                                          Add lock reason

                                                                                                          You can now add a reason when you lock an issue.

                                                                                                          Custom media type: sailor-v-preview Announced: 2018-01-10

                                                                                                          Organization invitations

                                                                                                          You can now use the API to invite new users to an organization by creating an organization invitation.

                                                                                                          Custom media type: dazzler-preview Announced: 2018-01-25

                                                                                                          tmp/developer.github.com/v3/projects/index.html Projects | GitHub Developer Guide

                                                                                                          Projects

                                                                                                          Note: To help with migrating from our REST API v3 to GraphQL API v4, we're introducing a preview period to include the GraphQL node_id in the response for many REST API v3 resources. See the blog post for full details. To access node_id during the preview period, you must provide a custom media type in the Accept header:

                                                                                                          application/vnd.github.jean-grey-preview+json
                                                                                                          

                                                                                                          Warning: The API may change without advance notice during the preview period. Preview features are not supported for production use. If you experience any issues, contact GitHub support.

                                                                                                          The Projects API is currently available for developers to preview. During the preview period, the API may change without advance notice. Please see the blog post for full details.

                                                                                                          To access the API during the preview period, you must provide a custom media type in the Accept header:

                                                                                                            application/vnd.github.inertia-preview+json
                                                                                                          

                                                                                                          List repository projects

                                                                                                          GET /repos/:owner/:repo/projects
                                                                                                          

                                                                                                          Parameters

                                                                                                          Name Type Description
                                                                                                          state string Indicates the state of the projects to return. Can be either open, closed, or all. Default: open

                                                                                                          Response

                                                                                                          Status: 200 OK
                                                                                                          Link: <https://api.github.com/resource?page=2>; rel="next",
                                                                                                                <https://api.github.com/resource?page=5>; rel="last"
                                                                                                          
                                                                                                          [
                                                                                                            {
                                                                                                              "owner_url": "https://api.github.com/repos/api-playground/projects-test",
                                                                                                              "url": "https://api.github.com/projects/1002604",
                                                                                                              "html_url": "https://github.com/api-playground/projects-test/projects/12",
                                                                                                              "columns_url": "https://api.github.com/projects/1002604/columns",
                                                                                                              "id": 1002604,
                                                                                                              "name": "Projects Documentation",
                                                                                                              "body": "Developer documentation project for the developer site.",
                                                                                                              "number": 1,
                                                                                                              "state": "open",
                                                                                                              "creator": {
                                                                                                                "login": "octocat",
                                                                                                                "id": 1,
                                                                                                                "avatar_url": "https://github.com/images/error/octocat_happy.gif",
                                                                                                                "gravatar_id": "",
                                                                                                                "url": "https://api.github.com/users/octocat",
                                                                                                                "html_url": "https://github.com/octocat",
                                                                                                                "followers_url": "https://api.github.com/users/octocat/followers",
                                                                                                                "following_url": "https://api.github.com/users/octocat/following{/other_user}",
                                                                                                                "gists_url": "https://api.github.com/users/octocat/gists{/gist_id}",
                                                                                                                "starred_url": "https://api.github.com/users/octocat/starred{/owner}{/repo}",
                                                                                                                "subscriptions_url": "https://api.github.com/users/octocat/subscriptions",
                                                                                                                "organizations_url": "https://api.github.com/users/octocat/orgs",
                                                                                                                "repos_url": "https://api.github.com/users/octocat/repos",
                                                                                                                "events_url": "https://api.github.com/users/octocat/events{/privacy}",
                                                                                                                "received_events_url": "https://api.github.com/users/octocat/received_events",
                                                                                                                "type": "User",
                                                                                                                "site_admin": false
                                                                                                              },
                                                                                                              "created_at": "2011-04-10T20:09:31Z",
                                                                                                              "updated_at": "2014-03-03T18:58:10Z"
                                                                                                            }
                                                                                                          ]
                                                                                                          

                                                                                                          Response if projects are disabled

                                                                                                          Status: 404 Not Found
                                                                                                          
                                                                                                          {
                                                                                                            "message": "Projects are disabled for this repo",
                                                                                                            "documentation_url": "https://developer.github.com/v3"
                                                                                                          }
                                                                                                          

                                                                                                          Note: The status code may also be 401 or 410, depending on the scope of the authenticating token.

                                                                                                          List organization projects

                                                                                                          GET /orgs/:org/projects
                                                                                                          

                                                                                                          Parameters

                                                                                                          Name Type Description
                                                                                                          state string Indicates the state of the projects to return. Can be either open, closed, or all. Default: open

                                                                                                          Response

                                                                                                          Status: 200 OK
                                                                                                          Link: <https://api.github.com/resource?page=2>; rel="next",
                                                                                                                <https://api.github.com/resource?page=5>; rel="last"
                                                                                                          
                                                                                                          [
                                                                                                            {
                                                                                                              "owner_url": "https://api.github.com/orgs/octocat",
                                                                                                              "url": "https://api.github.com/projects/1002605",
                                                                                                              "html_url": "https://github.com/orgs/api-playground/projects/13",
                                                                                                              "columns_url": "https://api.github.com/projects/1002605/columns",
                                                                                                              "id": 1002605,
                                                                                                              "name": "Organization Roadmap",
                                                                                                              "body": "High-level roadmap for the upcoming year.",
                                                                                                              "number": 1,
                                                                                                              "state": "open",
                                                                                                              "creator": {
                                                                                                                "login": "octocat",
                                                                                                                "id": 1,
                                                                                                                "avatar_url": "https://github.com/images/error/octocat_happy.gif",
                                                                                                                "gravatar_id": "",
                                                                                                                "url": "https://api.github.com/users/octocat",
                                                                                                                "html_url": "https://github.com/octocat",
                                                                                                                "followers_url": "https://api.github.com/users/octocat/followers",
                                                                                                                "following_url": "https://api.github.com/users/octocat/following{/other_user}",
                                                                                                                "gists_url": "https://api.github.com/users/octocat/gists{/gist_id}",
                                                                                                                "starred_url": "https://api.github.com/users/octocat/starred{/owner}{/repo}",
                                                                                                                "subscriptions_url": "https://api.github.com/users/octocat/subscriptions",
                                                                                                                "organizations_url": "https://api.github.com/users/octocat/orgs",
                                                                                                                "repos_url": "https://api.github.com/users/octocat/repos",
                                                                                                                "events_url": "https://api.github.com/users/octocat/events{/privacy}",
                                                                                                                "received_events_url": "https://api.github.com/users/octocat/received_events",
                                                                                                                "type": "User",
                                                                                                                "site_admin": false
                                                                                                              },
                                                                                                              "created_at": "2011-04-11T20:09:31Z",
                                                                                                              "updated_at": "2014-03-04T18:58:10Z"
                                                                                                            }
                                                                                                          ]
                                                                                                          

                                                                                                          Response if projects are disabled

                                                                                                          Status: 404 Not Found
                                                                                                          
                                                                                                          {
                                                                                                            "message": "Projects are disabled for this org",
                                                                                                            "documentation_url": "https://developer.github.com/v3"
                                                                                                          }
                                                                                                          

                                                                                                          Note: The status code may also be 401 or 410, depending on the scope of the authenticating token.

                                                                                                          Get a project

                                                                                                          GET /projects/:project_id
                                                                                                          

                                                                                                          Response

                                                                                                          Status: 200 OK
                                                                                                          Link: <https://api.github.com/resource?page=2>; rel="next",
                                                                                                                <https://api.github.com/resource?page=5>; rel="last"
                                                                                                          
                                                                                                          {
                                                                                                            "owner_url": "https://api.github.com/repos/api-playground/projects-test",
                                                                                                            "url": "https://api.github.com/projects/1002604",
                                                                                                            "html_url": "https://github.com/api-playground/projects-test/projects/12",
                                                                                                            "columns_url": "https://api.github.com/projects/1002604/columns",
                                                                                                            "id": 1002604,
                                                                                                            "name": "Projects Documentation",
                                                                                                            "body": "Developer documentation project for the developer site.",
                                                                                                            "number": 1,
                                                                                                            "state": "open",
                                                                                                            "creator": {
                                                                                                              "login": "octocat",
                                                                                                              "id": 1,
                                                                                                              "avatar_url": "https://github.com/images/error/octocat_happy.gif",
                                                                                                              "gravatar_id": "",
                                                                                                              "url": "https://api.github.com/users/octocat",
                                                                                                              "html_url": "https://github.com/octocat",
                                                                                                              "followers_url": "https://api.github.com/users/octocat/followers",
                                                                                                              "following_url": "https://api.github.com/users/octocat/following{/other_user}",
                                                                                                              "gists_url": "https://api.github.com/users/octocat/gists{/gist_id}",
                                                                                                              "starred_url": "https://api.github.com/users/octocat/starred{/owner}{/repo}",
                                                                                                              "subscriptions_url": "https://api.github.com/users/octocat/subscriptions",
                                                                                                              "organizations_url": "https://api.github.com/users/octocat/orgs",
                                                                                                              "repos_url": "https://api.github.com/users/octocat/repos",
                                                                                                              "events_url": "https://api.github.com/users/octocat/events{/privacy}",
                                                                                                              "received_events_url": "https://api.github.com/users/octocat/received_events",
                                                                                                              "type": "User",
                                                                                                              "site_admin": false
                                                                                                            },
                                                                                                            "created_at": "2011-04-10T20:09:31Z",
                                                                                                            "updated_at": "2014-03-03T18:58:10Z"
                                                                                                          }
                                                                                                          

                                                                                                          Response if projects are disabled

                                                                                                          Status: 404 Not Found
                                                                                                          
                                                                                                          {
                                                                                                            "message": "Projects are disabled for this repo",
                                                                                                            "documentation_url": "https://developer.github.com/v3"
                                                                                                          }
                                                                                                          

                                                                                                          Note: The status code may also be 401 or 410, depending on the scope of the authenticating token.

                                                                                                          Create a repository project

                                                                                                          POST /repos/:owner/:repo/projects
                                                                                                          

                                                                                                          Input

                                                                                                          Name Type Description
                                                                                                          name string Required. The name of the project.
                                                                                                          body string The body of the project.

                                                                                                          Example

                                                                                                          {
                                                                                                            "name": "Projects Documentation",
                                                                                                            "body": "Developer documentation project for the developer site."
                                                                                                          }
                                                                                                          

                                                                                                          Response

                                                                                                          Status: 201 Created
                                                                                                          Link: <https://api.github.com/resource?page=2>; rel="next",
                                                                                                                <https://api.github.com/resource?page=5>; rel="last"
                                                                                                          
                                                                                                          {
                                                                                                            "owner_url": "https://api.github.com/repos/api-playground/projects-test",
                                                                                                            "url": "https://api.github.com/projects/1002604",
                                                                                                            "html_url": "https://github.com/api-playground/projects-test/projects/12",
                                                                                                            "columns_url": "https://api.github.com/projects/1002604/columns",
                                                                                                            "id": 1002604,
                                                                                                            "name": "Projects Documentation",
                                                                                                            "body": "Developer documentation project for the developer site.",
                                                                                                            "number": 1,
                                                                                                            "state": "open",
                                                                                                            "creator": {
                                                                                                              "login": "octocat",
                                                                                                              "id": 1,
                                                                                                              "avatar_url": "https://github.com/images/error/octocat_happy.gif",
                                                                                                              "gravatar_id": "",
                                                                                                              "url": "https://api.github.com/users/octocat",
                                                                                                              "html_url": "https://github.com/octocat",
                                                                                                              "followers_url": "https://api.github.com/users/octocat/followers",
                                                                                                              "following_url": "https://api.github.com/users/octocat/following{/other_user}",
                                                                                                              "gists_url": "https://api.github.com/users/octocat/gists{/gist_id}",
                                                                                                              "starred_url": "https://api.github.com/users/octocat/starred{/owner}{/repo}",
                                                                                                              "subscriptions_url": "https://api.github.com/users/octocat/subscriptions",
                                                                                                              "organizations_url": "https://api.github.com/users/octocat/orgs",
                                                                                                              "repos_url": "https://api.github.com/users/octocat/repos",
                                                                                                              "events_url": "https://api.github.com/users/octocat/events{/privacy}",
                                                                                                              "received_events_url": "https://api.github.com/users/octocat/received_events",
                                                                                                              "type": "User",
                                                                                                              "site_admin": false
                                                                                                            },
                                                                                                            "created_at": "2011-04-10T20:09:31Z",
                                                                                                            "updated_at": "2014-03-03T18:58:10Z"
                                                                                                          }
                                                                                                          

                                                                                                          Response if projects are disabled

                                                                                                          Status: 404 Not Found
                                                                                                          
                                                                                                          {
                                                                                                            "message": "Projects are disabled for this repo",
                                                                                                            "documentation_url": "https://developer.github.com/v3"
                                                                                                          }
                                                                                                          

                                                                                                          Note: The status code may also be 401 or 410, depending on the scope of the authenticating token.

                                                                                                          Create an organization project

                                                                                                          POST /orgs/:org/projects
                                                                                                          

                                                                                                          Input

                                                                                                          Name Type Description
                                                                                                          name string Required. The name of the project.
                                                                                                          body string The body of the project.

                                                                                                          Example

                                                                                                          {
                                                                                                            "name": "Organization Roadmap",
                                                                                                            "body": "High-level roadmap for the upcoming year."
                                                                                                          }
                                                                                                          

                                                                                                          Response

                                                                                                          Status: 201 Created
                                                                                                          Link: <https://api.github.com/resource?page=2>; rel="next",
                                                                                                                <https://api.github.com/resource?page=5>; rel="last"
                                                                                                          
                                                                                                          {
                                                                                                            "owner_url": "https://api.github.com/orgs/octocat",
                                                                                                            "url": "https://api.github.com/projects/1002605",
                                                                                                            "html_url": "https://github.com/orgs/api-playground/projects/13",
                                                                                                            "columns_url": "https://api.github.com/projects/1002605/columns",
                                                                                                            "id": 1002605,
                                                                                                            "name": "Organization Roadmap",
                                                                                                            "body": "High-level roadmap for the upcoming year.",
                                                                                                            "number": 1,
                                                                                                            "state": "open",
                                                                                                            "creator": {
                                                                                                              "login": "octocat",
                                                                                                              "id": 1,
                                                                                                              "avatar_url": "https://github.com/images/error/octocat_happy.gif",
                                                                                                              "gravatar_id": "",
                                                                                                              "url": "https://api.github.com/users/octocat",
                                                                                                              "html_url": "https://github.com/octocat",
                                                                                                              "followers_url": "https://api.github.com/users/octocat/followers",
                                                                                                              "following_url": "https://api.github.com/users/octocat/following{/other_user}",
                                                                                                              "gists_url": "https://api.github.com/users/octocat/gists{/gist_id}",
                                                                                                              "starred_url": "https://api.github.com/users/octocat/starred{/owner}{/repo}",
                                                                                                              "subscriptions_url": "https://api.github.com/users/octocat/subscriptions",
                                                                                                              "organizations_url": "https://api.github.com/users/octocat/orgs",
                                                                                                              "repos_url": "https://api.github.com/users/octocat/repos",
                                                                                                              "events_url": "https://api.github.com/users/octocat/events{/privacy}",
                                                                                                              "received_events_url": "https://api.github.com/users/octocat/received_events",
                                                                                                              "type": "User",
                                                                                                              "site_admin": false
                                                                                                            },
                                                                                                            "created_at": "2011-04-11T20:09:31Z",
                                                                                                            "updated_at": "2014-03-04T18:58:10Z"
                                                                                                          }
                                                                                                          

                                                                                                          Response if projects are disabled

                                                                                                          Status: 404 Not Found
                                                                                                          
                                                                                                          {
                                                                                                            "message": "Projects are disabled for this org",
                                                                                                            "documentation_url": "https://developer.github.com/v3"
                                                                                                          }
                                                                                                          

                                                                                                          Note: The status code may also be 401 or 410, depending on the scope of the authenticating token.

                                                                                                          Update a project

                                                                                                          PATCH /projects/:project_id
                                                                                                          

                                                                                                          Parameters

                                                                                                          Name Type Description
                                                                                                          name string The name of the project.
                                                                                                          body string The body of the project.
                                                                                                          state string State of the project. Either open or closed.

                                                                                                          Example

                                                                                                          {
                                                                                                            "name": "Outcomes Tracker",
                                                                                                            "body": "The board to track work for the Outcomes application."
                                                                                                          }
                                                                                                          

                                                                                                          Response

                                                                                                          Status: 200 OK
                                                                                                          Link: <https://api.github.com/resource?page=2>; rel="next",
                                                                                                                <https://api.github.com/resource?page=5>; rel="last"
                                                                                                          
                                                                                                          {
                                                                                                            "owner_url": "https://api.github.com/repos/api-playground/projects-test",
                                                                                                            "url": "https://api.github.com/projects/1002604",
                                                                                                            "html_url": "https://github.com/api-playground/projects-test/projects/12",
                                                                                                            "columns_url": "https://api.github.com/projects/1002604/columns",
                                                                                                            "id": 1002604,
                                                                                                            "name": "Projects Documentation",
                                                                                                            "body": "Developer documentation project for the developer site.",
                                                                                                            "number": 1,
                                                                                                            "state": "open",
                                                                                                            "creator": {
                                                                                                              "login": "octocat",
                                                                                                              "id": 1,
                                                                                                              "avatar_url": "https://github.com/images/error/octocat_happy.gif",
                                                                                                              "gravatar_id": "",
                                                                                                              "url": "https://api.github.com/users/octocat",
                                                                                                              "html_url": "https://github.com/octocat",
                                                                                                              "followers_url": "https://api.github.com/users/octocat/followers",
                                                                                                              "following_url": "https://api.github.com/users/octocat/following{/other_user}",
                                                                                                              "gists_url": "https://api.github.com/users/octocat/gists{/gist_id}",
                                                                                                              "starred_url": "https://api.github.com/users/octocat/starred{/owner}{/repo}",
                                                                                                              "subscriptions_url": "https://api.github.com/users/octocat/subscriptions",
                                                                                                              "organizations_url": "https://api.github.com/users/octocat/orgs",
                                                                                                              "repos_url": "https://api.github.com/users/octocat/repos",
                                                                                                              "events_url": "https://api.github.com/users/octocat/events{/privacy}",
                                                                                                              "received_events_url": "https://api.github.com/users/octocat/received_events",
                                                                                                              "type": "User",
                                                                                                              "site_admin": false
                                                                                                            },
                                                                                                            "created_at": "2011-04-10T20:09:31Z",
                                                                                                            "updated_at": "2014-03-03T18:58:10Z"
                                                                                                          }
                                                                                                          

                                                                                                          Response if projects are disabled

                                                                                                          Status: 404 Not Found
                                                                                                          
                                                                                                          {
                                                                                                            "message": "Projects are disabled for this repo",
                                                                                                            "documentation_url": "https://developer.github.com/v3"
                                                                                                          }
                                                                                                          

                                                                                                          Note: The status code may also be 401 or 410, depending on the scope of the authenticating token.

                                                                                                          Delete a project

                                                                                                          DELETE /projects/:project_id
                                                                                                          
                                                                                                          Status: 204 No Content
                                                                                                          

                                                                                                          Response if projects are disabled

                                                                                                          Status: 404 Not Found
                                                                                                          
                                                                                                          {
                                                                                                            "message": "Projects are disabled for this repo",
                                                                                                            "documentation_url": "https://developer.github.com/v3"
                                                                                                          }
                                                                                                          
                                                                                                          tmp/developer.github.com/v3/projects/cards/index.html Project cards | GitHub Developer Guide

                                                                                                          Project cards

                                                                                                          The Projects API is currently available for developers to preview. During the preview period, the API may change without advance notice. Please see the blog post for full details.

                                                                                                          To access the API during the preview period, you must provide a custom media type in the Accept header:

                                                                                                            application/vnd.github.inertia-preview+json
                                                                                                          

                                                                                                          List project cards

                                                                                                          GET /projects/columns/:column_id/cards
                                                                                                          

                                                                                                          Response

                                                                                                          Status: 200 OK
                                                                                                          Link: <https://api.github.com/resource?page=2>; rel="next",
                                                                                                                <https://api.github.com/resource?page=5>; rel="last"
                                                                                                          
                                                                                                          [
                                                                                                            {
                                                                                                              "url": "https://api.github.com/projects/columns/cards/1478",
                                                                                                              "column_url": "https://api.github.com/projects/columns/367",
                                                                                                              "content_url": "https://api.github.com/repos/api-playground/projects-test/issues/3",
                                                                                                              "id": 1478,
                                                                                                              "note": "Add payload for delete Project column",
                                                                                                              "creator": {
                                                                                                                "login": "octocat",
                                                                                                                "id": 1,
                                                                                                                "avatar_url": "https://github.com/images/error/octocat_happy.gif",
                                                                                                                "gravatar_id": "",
                                                                                                                "url": "https://api.github.com/users/octocat",
                                                                                                                "html_url": "https://github.com/octocat",
                                                                                                                "followers_url": "https://api.github.com/users/octocat/followers",
                                                                                                                "following_url": "https://api.github.com/users/octocat/following{/other_user}",
                                                                                                                "gists_url": "https://api.github.com/users/octocat/gists{/gist_id}",
                                                                                                                "starred_url": "https://api.github.com/users/octocat/starred{/owner}{/repo}",
                                                                                                                "subscriptions_url": "https://api.github.com/users/octocat/subscriptions",
                                                                                                                "organizations_url": "https://api.github.com/users/octocat/orgs",
                                                                                                                "repos_url": "https://api.github.com/users/octocat/repos",
                                                                                                                "events_url": "https://api.github.com/users/octocat/events{/privacy}",
                                                                                                                "received_events_url": "https://api.github.com/users/octocat/received_events",
                                                                                                                "type": "User",
                                                                                                                "site_admin": false
                                                                                                              },
                                                                                                              "created_at": "2016-09-05T14:21:06Z",
                                                                                                              "updated_at": "2016-09-05T14:20:22Z"
                                                                                                            }
                                                                                                          ]
                                                                                                          

                                                                                                          Get a project card

                                                                                                          GET /projects/columns/cards/:card_id
                                                                                                          
                                                                                                          Status: 200 OK
                                                                                                          
                                                                                                          {
                                                                                                            "url": "https://api.github.com/projects/columns/cards/1478",
                                                                                                            "column_url": "https://api.github.com/projects/columns/367",
                                                                                                            "content_url": "https://api.github.com/repos/api-playground/projects-test/issues/3",
                                                                                                            "id": 1478,
                                                                                                            "note": "Add payload for delete Project column",
                                                                                                            "creator": {
                                                                                                              "login": "octocat",
                                                                                                              "id": 1,
                                                                                                              "avatar_url": "https://github.com/images/error/octocat_happy.gif",
                                                                                                              "gravatar_id": "",
                                                                                                              "url": "https://api.github.com/users/octocat",
                                                                                                              "html_url": "https://github.com/octocat",
                                                                                                              "followers_url": "https://api.github.com/users/octocat/followers",
                                                                                                              "following_url": "https://api.github.com/users/octocat/following{/other_user}",
                                                                                                              "gists_url": "https://api.github.com/users/octocat/gists{/gist_id}",
                                                                                                              "starred_url": "https://api.github.com/users/octocat/starred{/owner}{/repo}",
                                                                                                              "subscriptions_url": "https://api.github.com/users/octocat/subscriptions",
                                                                                                              "organizations_url": "https://api.github.com/users/octocat/orgs",
                                                                                                              "repos_url": "https://api.github.com/users/octocat/repos",
                                                                                                              "events_url": "https://api.github.com/users/octocat/events{/privacy}",
                                                                                                              "received_events_url": "https://api.github.com/users/octocat/received_events",
                                                                                                              "type": "User",
                                                                                                              "site_admin": false
                                                                                                            },
                                                                                                            "created_at": "2016-09-05T14:21:06Z",
                                                                                                            "updated_at": "2016-09-05T14:20:22Z"
                                                                                                          }
                                                                                                          

                                                                                                          Create a project card

                                                                                                          POST /projects/columns/:column_id/cards
                                                                                                          

                                                                                                          Parameters

                                                                                                          Name Type Description
                                                                                                          note string The card's note content. Only valid for cards without another type of content, so this must be omitted if content_id and content_type are specified.
                                                                                                          content_id integer The id of the issue to associate with this card.
                                                                                                          content_type string Required if you specify a content_id. The type of content to associate with this card. Can only be "Issue" at this time.

                                                                                                          Response

                                                                                                          Status: 200 OK
                                                                                                          
                                                                                                          {
                                                                                                            "url": "https://api.github.com/projects/columns/cards/1478",
                                                                                                            "column_url": "https://api.github.com/projects/columns/367",
                                                                                                            "content_url": "https://api.github.com/repos/api-playground/projects-test/issues/3",
                                                                                                            "id": 1478,
                                                                                                            "note": "Add payload for delete Project column",
                                                                                                            "creator": {
                                                                                                              "login": "octocat",
                                                                                                              "id": 1,
                                                                                                              "avatar_url": "https://github.com/images/error/octocat_happy.gif",
                                                                                                              "gravatar_id": "",
                                                                                                              "url": "https://api.github.com/users/octocat",
                                                                                                              "html_url": "https://github.com/octocat",
                                                                                                              "followers_url": "https://api.github.com/users/octocat/followers",
                                                                                                              "following_url": "https://api.github.com/users/octocat/following{/other_user}",
                                                                                                              "gists_url": "https://api.github.com/users/octocat/gists{/gist_id}",
                                                                                                              "starred_url": "https://api.github.com/users/octocat/starred{/owner}{/repo}",
                                                                                                              "subscriptions_url": "https://api.github.com/users/octocat/subscriptions",
                                                                                                              "organizations_url": "https://api.github.com/users/octocat/orgs",
                                                                                                              "repos_url": "https://api.github.com/users/octocat/repos",
                                                                                                              "events_url": "https://api.github.com/users/octocat/events{/privacy}",
                                                                                                              "received_events_url": "https://api.github.com/users/octocat/received_events",
                                                                                                              "type": "User",
                                                                                                              "site_admin": false
                                                                                                            },
                                                                                                            "created_at": "2016-09-05T14:21:06Z",
                                                                                                            "updated_at": "2016-09-05T14:20:22Z"
                                                                                                          }
                                                                                                          

                                                                                                          Update a project card

                                                                                                          PATCH /projects/columns/cards/:card_id
                                                                                                          

                                                                                                          Parameters

                                                                                                          Name Type Description
                                                                                                          note string The card's note content. Only valid for cards without another type of content, so this cannot be specified if the card already has a content_id and content_type.
                                                                                                          Status: 200 OK
                                                                                                          
                                                                                                          {
                                                                                                            "url": "https://api.github.com/projects/columns/cards/1478",
                                                                                                            "column_url": "https://api.github.com/projects/columns/367",
                                                                                                            "content_url": "https://api.github.com/repos/api-playground/projects-test/issues/3",
                                                                                                            "id": 1478,
                                                                                                            "note": "Add payload for delete Project column",
                                                                                                            "creator": {
                                                                                                              "login": "octocat",
                                                                                                              "id": 1,
                                                                                                              "avatar_url": "https://github.com/images/error/octocat_happy.gif",
                                                                                                              "gravatar_id": "",
                                                                                                              "url": "https://api.github.com/users/octocat",
                                                                                                              "html_url": "https://github.com/octocat",
                                                                                                              "followers_url": "https://api.github.com/users/octocat/followers",
                                                                                                              "following_url": "https://api.github.com/users/octocat/following{/other_user}",
                                                                                                              "gists_url": "https://api.github.com/users/octocat/gists{/gist_id}",
                                                                                                              "starred_url": "https://api.github.com/users/octocat/starred{/owner}{/repo}",
                                                                                                              "subscriptions_url": "https://api.github.com/users/octocat/subscriptions",
                                                                                                              "organizations_url": "https://api.github.com/users/octocat/orgs",
                                                                                                              "repos_url": "https://api.github.com/users/octocat/repos",
                                                                                                              "events_url": "https://api.github.com/users/octocat/events{/privacy}",
                                                                                                              "received_events_url": "https://api.github.com/users/octocat/received_events",
                                                                                                              "type": "User",
                                                                                                              "site_admin": false
                                                                                                            },
                                                                                                            "created_at": "2016-09-05T14:21:06Z",
                                                                                                            "updated_at": "2016-09-05T14:20:22Z"
                                                                                                          }
                                                                                                          

                                                                                                          Delete a project card

                                                                                                          DELETE /projects/columns/cards/:card_id
                                                                                                          

                                                                                                          Response

                                                                                                          Status: 204 No Content
                                                                                                          

                                                                                                          Move a project card

                                                                                                          POST /projects/columns/cards/:card_id/moves
                                                                                                          

                                                                                                          Parameters

                                                                                                          Name Type Description
                                                                                                          position string Required. Can be one of top, bottom, or after:<card_id>, where <card_id> is the id value of a card in the same column, or in the new column specified by column_id.
                                                                                                          column_id integer The id value of a column in the same project.

                                                                                                          Example

                                                                                                          {
                                                                                                            "position": "after:3",
                                                                                                            "column_id": 5
                                                                                                          }
                                                                                                          

                                                                                                          Response

                                                                                                          Status: 201 Created
                                                                                                          
                                                                                                          tmp/developer.github.com/v3/projects/columns/index.html Project columns | GitHub Developer Guide

                                                                                                          Project columns

                                                                                                          The Projects API is currently available for developers to preview. During the preview period, the API may change without advance notice. Please see the blog post for full details.

                                                                                                          To access the API during the preview period, you must provide a custom media type in the Accept header:

                                                                                                            application/vnd.github.inertia-preview+json
                                                                                                          

                                                                                                          List project columns

                                                                                                          GET /projects/:project_id/columns
                                                                                                          

                                                                                                          Response

                                                                                                          Status: 200 OK
                                                                                                          Link: <https://api.github.com/resource?page=2>; rel="next",
                                                                                                                <https://api.github.com/resource?page=5>; rel="last"
                                                                                                          
                                                                                                          [
                                                                                                            {
                                                                                                              "id": 367,
                                                                                                              "name": "To Do",
                                                                                                              "url": "https://api.github.com/projects/columns/367",
                                                                                                              "project_url": "https://api.github.com/projects/120",
                                                                                                              "cards_url": "https://api.github.com/projects/columns/367/cards",
                                                                                                              "created_at": "2016-09-05T14:18:44Z",
                                                                                                              "updated_at": "2016-09-05T14:22:28Z"
                                                                                                            }
                                                                                                          ]
                                                                                                          

                                                                                                          Get a project column

                                                                                                          GET /projects/columns/:column_id
                                                                                                          
                                                                                                          Status: 200 OK
                                                                                                          
                                                                                                          {
                                                                                                            "id": 367,
                                                                                                            "name": "To Do",
                                                                                                            "url": "https://api.github.com/projects/columns/367",
                                                                                                            "project_url": "https://api.github.com/projects/120",
                                                                                                            "cards_url": "https://api.github.com/projects/columns/367/cards",
                                                                                                            "created_at": "2016-09-05T14:18:44Z",
                                                                                                            "updated_at": "2016-09-05T14:22:28Z"
                                                                                                          }
                                                                                                          

                                                                                                          Create a project column

                                                                                                          POST /projects/:project_id/columns
                                                                                                          

                                                                                                          Parameters

                                                                                                          Name Type Description
                                                                                                          name string Required. The name of the column.
                                                                                                          Status: 200 OK
                                                                                                          
                                                                                                          {
                                                                                                            "id": 367,
                                                                                                            "name": "To Do",
                                                                                                            "url": "https://api.github.com/projects/columns/367",
                                                                                                            "project_url": "https://api.github.com/projects/120",
                                                                                                            "cards_url": "https://api.github.com/projects/columns/367/cards",
                                                                                                            "created_at": "2016-09-05T14:18:44Z",
                                                                                                            "updated_at": "2016-09-05T14:22:28Z"
                                                                                                          }
                                                                                                          

                                                                                                          Update a project column

                                                                                                          PATCH /projects/columns/:column_id
                                                                                                          

                                                                                                          Parameters

                                                                                                          Name Type Description
                                                                                                          name string Required. The new name of the column.
                                                                                                          Status: 200 OK
                                                                                                          
                                                                                                          {
                                                                                                            "id": 367,
                                                                                                            "name": "To Do",
                                                                                                            "url": "https://api.github.com/projects/columns/367",
                                                                                                            "project_url": "https://api.github.com/projects/120",
                                                                                                            "cards_url": "https://api.github.com/projects/columns/367/cards",
                                                                                                            "created_at": "2016-09-05T14:18:44Z",
                                                                                                            "updated_at": "2016-09-05T14:22:28Z"
                                                                                                          }
                                                                                                          

                                                                                                          Delete a project column

                                                                                                          DELETE /projects/columns/:column_id
                                                                                                          

                                                                                                          Response

                                                                                                          Status: 204 No Content
                                                                                                          

                                                                                                          Move a project column

                                                                                                          POST /projects/columns/:column_id/moves
                                                                                                          

                                                                                                          Parameters

                                                                                                          Name Type Description
                                                                                                          position string Required. Can be one of first, last, or after:<column_id>, where <column_id> is the id value of a column in the same project.

                                                                                                          Example

                                                                                                          {
                                                                                                            "position": "after:3"
                                                                                                          }
                                                                                                          

                                                                                                          Response

                                                                                                          Status: 201 Created
                                                                                                          
                                                                                                          tmp/developer.github.com/v3/pulls/index.html Pull Requests | GitHub Developer Guide

                                                                                                          Pull Requests

                                                                                                          The Pull Request API allows you to list, view, edit, create, and even merge pull requests. Comments on pull requests can be managed via the Issue Comments API.

                                                                                                          Pull Requests use these custom media types. You can read more about the use of media types in the API here.

                                                                                                          Note: To help with migrating from our REST API v3 to GraphQL API v4, we're introducing a preview period to include the GraphQL node_id in the response for many REST API v3 resources. See the blog post for full details. To access node_id during the preview period, you must provide a custom media type in the Accept header:

                                                                                                          application/vnd.github.jean-grey-preview+json
                                                                                                          

                                                                                                          Warning: The API may change without advance notice during the preview period. Preview features are not supported for production use. If you experience any issues, contact GitHub support.

                                                                                                          Link Relations

                                                                                                          Pull Requests have these possible link relations:

                                                                                                          Name Description
                                                                                                          self The API location of this Pull Request.
                                                                                                          html The HTML location of this Pull Request.
                                                                                                          issue The API location of this Pull Request's Issue.
                                                                                                          comments The API location of this Pull Request's Issue comments.
                                                                                                          review_comments The API location of this Pull Request's Review comments.
                                                                                                          review_comment The URL template to construct the API location for a Review comment in this Pull Request's repository.
                                                                                                          commits The API location of this Pull Request's commits.
                                                                                                          statuses The API location of this Pull Request's commit statuses, which are the statuses of its head branch.

                                                                                                          List pull requests

                                                                                                          GET /repos/:owner/:repo/pulls
                                                                                                          

                                                                                                          Parameters

                                                                                                          Name Type Description
                                                                                                          state string Either open, closed, or all to filter by state. Default: open
                                                                                                          head string Filter pulls by head user and branch name in the format of user:ref-name. Example: github:new-script-format.
                                                                                                          base string Filter pulls by base branch name. Example: gh-pages.
                                                                                                          sort string What to sort results by. Can be either created, updated, popularity (comment count) or long-running (age, filtering by pulls updated in the last month). Default: created
                                                                                                          direction string The direction of the sort. Can be either asc or desc. Default: desc when sort is created or sort is not specified, otherwise asc.

                                                                                                          Response

                                                                                                          Status: 200 OK
                                                                                                          Link: <https://api.github.com/resource?page=2>; rel="next",
                                                                                                                <https://api.github.com/resource?page=5>; rel="last"
                                                                                                          
                                                                                                          [
                                                                                                            {
                                                                                                              "id": 1,
                                                                                                              "url": "https://api.github.com/repos/octocat/Hello-World/pulls/1347",
                                                                                                              "html_url": "https://github.com/octocat/Hello-World/pull/1347",
                                                                                                              "diff_url": "https://github.com/octocat/Hello-World/pull/1347.diff",
                                                                                                              "patch_url": "https://github.com/octocat/Hello-World/pull/1347.patch",
                                                                                                              "issue_url": "https://api.github.com/repos/octocat/Hello-World/issues/1347",
                                                                                                              "commits_url": "https://api.github.com/repos/octocat/Hello-World/pulls/1347/commits",
                                                                                                              "review_comments_url": "https://api.github.com/repos/octocat/Hello-World/pulls/1347/comments",
                                                                                                              "review_comment_url": "https://api.github.com/repos/octocat/Hello-World/pulls/comments{/number}",
                                                                                                              "comments_url": "https://api.github.com/repos/octocat/Hello-World/issues/1347/comments",
                                                                                                              "statuses_url": "https://api.github.com/repos/octocat/Hello-World/statuses/6dcb09b5b57875f334f61aebed695e2e4193db5e",
                                                                                                              "number": 1347,
                                                                                                              "state": "open",
                                                                                                              "title": "new-feature",
                                                                                                              "body": "Please pull these awesome changes",
                                                                                                              "assignee": {
                                                                                                                "login": "octocat",
                                                                                                                "id": 1,
                                                                                                                "avatar_url": "https://github.com/images/error/octocat_happy.gif",
                                                                                                                "gravatar_id": "",
                                                                                                                "url": "https://api.github.com/users/octocat",
                                                                                                                "html_url": "https://github.com/octocat",
                                                                                                                "followers_url": "https://api.github.com/users/octocat/followers",
                                                                                                                "following_url": "https://api.github.com/users/octocat/following{/other_user}",
                                                                                                                "gists_url": "https://api.github.com/users/octocat/gists{/gist_id}",
                                                                                                                "starred_url": "https://api.github.com/users/octocat/starred{/owner}{/repo}",
                                                                                                                "subscriptions_url": "https://api.github.com/users/octocat/subscriptions",
                                                                                                                "organizations_url": "https://api.github.com/users/octocat/orgs",
                                                                                                                "repos_url": "https://api.github.com/users/octocat/repos",
                                                                                                                "events_url": "https://api.github.com/users/octocat/events{/privacy}",
                                                                                                                "received_events_url": "https://api.github.com/users/octocat/received_events",
                                                                                                                "type": "User",
                                                                                                                "site_admin": false
                                                                                                              },
                                                                                                              "milestone": {
                                                                                                                "url": "https://api.github.com/repos/octocat/Hello-World/milestones/1",
                                                                                                                "html_url": "https://github.com/octocat/Hello-World/milestones/v1.0",
                                                                                                                "labels_url": "https://api.github.com/repos/octocat/Hello-World/milestones/1/labels",
                                                                                                                "id": 1002604,
                                                                                                                "number": 1,
                                                                                                                "state": "open",
                                                                                                                "title": "v1.0",
                                                                                                                "description": "Tracking milestone for version 1.0",
                                                                                                                "creator": {
                                                                                                                  "login": "octocat",
                                                                                                                  "id": 1,
                                                                                                                  "avatar_url": "https://github.com/images/error/octocat_happy.gif",
                                                                                                                  "gravatar_id": "",
                                                                                                                  "url": "https://api.github.com/users/octocat",
                                                                                                                  "html_url": "https://github.com/octocat",
                                                                                                                  "followers_url": "https://api.github.com/users/octocat/followers",
                                                                                                                  "following_url": "https://api.github.com/users/octocat/following{/other_user}",
                                                                                                                  "gists_url": "https://api.github.com/users/octocat/gists{/gist_id}",
                                                                                                                  "starred_url": "https://api.github.com/users/octocat/starred{/owner}{/repo}",
                                                                                                                  "subscriptions_url": "https://api.github.com/users/octocat/subscriptions",
                                                                                                                  "organizations_url": "https://api.github.com/users/octocat/orgs",
                                                                                                                  "repos_url": "https://api.github.com/users/octocat/repos",
                                                                                                                  "events_url": "https://api.github.com/users/octocat/events{/privacy}",
                                                                                                                  "received_events_url": "https://api.github.com/users/octocat/received_events",
                                                                                                                  "type": "User",
                                                                                                                  "site_admin": false
                                                                                                                },
                                                                                                                "open_issues": 4,
                                                                                                                "closed_issues": 8,
                                                                                                                "created_at": "2011-04-10T20:09:31Z",
                                                                                                                "updated_at": "2014-03-03T18:58:10Z",
                                                                                                                "closed_at": "2013-02-12T13:22:01Z",
                                                                                                                "due_on": "2012-10-09T23:39:01Z"
                                                                                                              },
                                                                                                              "locked": true,
                                                                                                              "active_lock_reason": "too heated",
                                                                                                              "created_at": "2011-01-26T19:01:12Z",
                                                                                                              "updated_at": "2011-01-26T19:01:12Z",
                                                                                                              "closed_at": "2011-01-26T19:01:12Z",
                                                                                                              "merged_at": "2011-01-26T19:01:12Z",
                                                                                                              "head": {
                                                                                                                "label": "new-topic",
                                                                                                                "ref": "new-topic",
                                                                                                                "sha": "6dcb09b5b57875f334f61aebed695e2e4193db5e",
                                                                                                                "user": {
                                                                                                                  "login": "octocat",
                                                                                                                  "id": 1,
                                                                                                                  "avatar_url": "https://github.com/images/error/octocat_happy.gif",
                                                                                                                  "gravatar_id": "",
                                                                                                                  "url": "https://api.github.com/users/octocat",
                                                                                                                  "html_url": "https://github.com/octocat",
                                                                                                                  "followers_url": "https://api.github.com/users/octocat/followers",
                                                                                                                  "following_url": "https://api.github.com/users/octocat/following{/other_user}",
                                                                                                                  "gists_url": "https://api.github.com/users/octocat/gists{/gist_id}",
                                                                                                                  "starred_url": "https://api.github.com/users/octocat/starred{/owner}{/repo}",
                                                                                                                  "subscriptions_url": "https://api.github.com/users/octocat/subscriptions",
                                                                                                                  "organizations_url": "https://api.github.com/users/octocat/orgs",
                                                                                                                  "repos_url": "https://api.github.com/users/octocat/repos",
                                                                                                                  "events_url": "https://api.github.com/users/octocat/events{/privacy}",
                                                                                                                  "received_events_url": "https://api.github.com/users/octocat/received_events",
                                                                                                                  "type": "User",
                                                                                                                  "site_admin": false
                                                                                                                },
                                                                                                                "repo": {
                                                                                                                  "id": 1296269,
                                                                                                                  "owner": {
                                                                                                                    "login": "octocat",
                                                                                                                    "id": 1,
                                                                                                                    "avatar_url": "https://github.com/images/error/octocat_happy.gif",
                                                                                                                    "gravatar_id": "",
                                                                                                                    "url": "https://api.github.com/users/octocat",
                                                                                                                    "html_url": "https://github.com/octocat",
                                                                                                                    "followers_url": "https://api.github.com/users/octocat/followers",
                                                                                                                    "following_url": "https://api.github.com/users/octocat/following{/other_user}",
                                                                                                                    "gists_url": "https://api.github.com/users/octocat/gists{/gist_id}",
                                                                                                                    "starred_url": "https://api.github.com/users/octocat/starred{/owner}{/repo}",
                                                                                                                    "subscriptions_url": "https://api.github.com/users/octocat/subscriptions",
                                                                                                                    "organizations_url": "https://api.github.com/users/octocat/orgs",
                                                                                                                    "repos_url": "https://api.github.com/users/octocat/repos",
                                                                                                                    "events_url": "https://api.github.com/users/octocat/events{/privacy}",
                                                                                                                    "received_events_url": "https://api.github.com/users/octocat/received_events",
                                                                                                                    "type": "User",
                                                                                                                    "site_admin": false
                                                                                                                  },
                                                                                                                  "name": "Hello-World",
                                                                                                                  "full_name": "octocat/Hello-World",
                                                                                                                  "description": "This your first repo!",
                                                                                                                  "private": false,
                                                                                                                  "fork": false,
                                                                                                                  "url": "https://api.github.com/repos/octocat/Hello-World",
                                                                                                                  "html_url": "https://github.com/octocat/Hello-World",
                                                                                                                  "archive_url": "http://api.github.com/repos/octocat/Hello-World/{archive_format}{/ref}",
                                                                                                                  "assignees_url": "http://api.github.com/repos/octocat/Hello-World/assignees{/user}",
                                                                                                                  "blobs_url": "http://api.github.com/repos/octocat/Hello-World/git/blobs{/sha}",
                                                                                                                  "branches_url": "http://api.github.com/repos/octocat/Hello-World/branches{/branch}",
                                                                                                                  "clone_url": "https://github.com/octocat/Hello-World.git",
                                                                                                                  "collaborators_url": "http://api.github.com/repos/octocat/Hello-World/collaborators{/collaborator}",
                                                                                                                  "comments_url": "http://api.github.com/repos/octocat/Hello-World/comments{/number}",
                                                                                                                  "commits_url": "http://api.github.com/repos/octocat/Hello-World/commits{/sha}",
                                                                                                                  "compare_url": "http://api.github.com/repos/octocat/Hello-World/compare/{base}...{head}",
                                                                                                                  "contents_url": "http://api.github.com/repos/octocat/Hello-World/contents/{+path}",
                                                                                                                  "contributors_url": "http://api.github.com/repos/octocat/Hello-World/contributors",
                                                                                                                  "deployments_url": "http://api.github.com/repos/octocat/Hello-World/deployments",
                                                                                                                  "downloads_url": "http://api.github.com/repos/octocat/Hello-World/downloads",
                                                                                                                  "events_url": "http://api.github.com/repos/octocat/Hello-World/events",
                                                                                                                  "forks_url": "http://api.github.com/repos/octocat/Hello-World/forks",
                                                                                                                  "git_commits_url": "http://api.github.com/repos/octocat/Hello-World/git/commits{/sha}",
                                                                                                                  "git_refs_url": "http://api.github.com/repos/octocat/Hello-World/git/refs{/sha}",
                                                                                                                  "git_tags_url": "http://api.github.com/repos/octocat/Hello-World/git/tags{/sha}",
                                                                                                                  "git_url": "git:github.com/octocat/Hello-World.git",
                                                                                                                  "hooks_url": "http://api.github.com/repos/octocat/Hello-World/hooks",
                                                                                                                  "issue_comment_url": "http://api.github.com/repos/octocat/Hello-World/issues/comments{/number}",
                                                                                                                  "issue_events_url": "http://api.github.com/repos/octocat/Hello-World/issues/events{/number}",
                                                                                                                  "issues_url": "http://api.github.com/repos/octocat/Hello-World/issues{/number}",
                                                                                                                  "keys_url": "http://api.github.com/repos/octocat/Hello-World/keys{/key_id}",
                                                                                                                  "labels_url": "http://api.github.com/repos/octocat/Hello-World/labels{/name}",
                                                                                                                  "languages_url": "http://api.github.com/repos/octocat/Hello-World/languages",
                                                                                                                  "merges_url": "http://api.github.com/repos/octocat/Hello-World/merges",
                                                                                                                  "milestones_url": "http://api.github.com/repos/octocat/Hello-World/milestones{/number}",
                                                                                                                  "mirror_url": "git:git.example.com/octocat/Hello-World",
                                                                                                                  "notifications_url": "http://api.github.com/repos/octocat/Hello-World/notifications{?since,all,participating}",
                                                                                                                  "pulls_url": "http://api.github.com/repos/octocat/Hello-World/pulls{/number}",
                                                                                                                  "releases_url": "http://api.github.com/repos/octocat/Hello-World/releases{/id}",
                                                                                                                  "ssh_url": "git@github.com:octocat/Hello-World.git",
                                                                                                                  "stargazers_url": "http://api.github.com/repos/octocat/Hello-World/stargazers",
                                                                                                                  "statuses_url": "http://api.github.com/repos/octocat/Hello-World/statuses/{sha}",
                                                                                                                  "subscribers_url": "http://api.github.com/repos/octocat/Hello-World/subscribers",
                                                                                                                  "subscription_url": "http://api.github.com/repos/octocat/Hello-World/subscription",
                                                                                                                  "svn_url": "https://svn.github.com/octocat/Hello-World",
                                                                                                                  "tags_url": "http://api.github.com/repos/octocat/Hello-World/tags",
                                                                                                                  "teams_url": "http://api.github.com/repos/octocat/Hello-World/teams",
                                                                                                                  "trees_url": "http://api.github.com/repos/octocat/Hello-World/git/trees{/sha}",
                                                                                                                  "homepage": "https://github.com",
                                                                                                                  "language": null,
                                                                                                                  "forks_count": 9,
                                                                                                                  "stargazers_count": 80,
                                                                                                                  "watchers_count": 80,
                                                                                                                  "size": 108,
                                                                                                                  "default_branch": "master",
                                                                                                                  "open_issues_count": 0,
                                                                                                                  "topics": [
                                                                                                                    "octocat",
                                                                                                                    "atom",
                                                                                                                    "electron",
                                                                                                                    "API"
                                                                                                                  ],
                                                                                                                  "has_issues": true,
                                                                                                                  "has_wiki": true,
                                                                                                                  "has_pages": false,
                                                                                                                  "has_downloads": true,
                                                                                                                  "archived": false,
                                                                                                                  "pushed_at": "2011-01-26T19:06:43Z",
                                                                                                                  "created_at": "2011-01-26T19:01:12Z",
                                                                                                                  "updated_at": "2011-01-26T19:14:43Z",
                                                                                                                  "permissions": {
                                                                                                                    "admin": false,
                                                                                                                    "push": false,
                                                                                                                    "pull": true
                                                                                                                  },
                                                                                                                  "allow_rebase_merge": true,
                                                                                                                  "allow_squash_merge": true,
                                                                                                                  "allow_merge_commit": true,
                                                                                                                  "subscribers_count": 42,
                                                                                                                  "network_count": 0
                                                                                                                }
                                                                                                              },
                                                                                                              "base": {
                                                                                                                "label": "master",
                                                                                                                "ref": "master",
                                                                                                                "sha": "6dcb09b5b57875f334f61aebed695e2e4193db5e",
                                                                                                                "user": {
                                                                                                                  "login": "octocat",
                                                                                                                  "id": 1,
                                                                                                                  "avatar_url": "https://github.com/images/error/octocat_happy.gif",
                                                                                                                  "gravatar_id": "",
                                                                                                                  "url": "https://api.github.com/users/octocat",
                                                                                                                  "html_url": "https://github.com/octocat",
                                                                                                                  "followers_url": "https://api.github.com/users/octocat/followers",
                                                                                                                  "following_url": "https://api.github.com/users/octocat/following{/other_user}",
                                                                                                                  "gists_url": "https://api.github.com/users/octocat/gists{/gist_id}",
                                                                                                                  "starred_url": "https://api.github.com/users/octocat/starred{/owner}{/repo}",
                                                                                                                  "subscriptions_url": "https://api.github.com/users/octocat/subscriptions",
                                                                                                                  "organizations_url": "https://api.github.com/users/octocat/orgs",
                                                                                                                  "repos_url": "https://api.github.com/users/octocat/repos",
                                                                                                                  "events_url": "https://api.github.com/users/octocat/events{/privacy}",
                                                                                                                  "received_events_url": "https://api.github.com/users/octocat/received_events",
                                                                                                                  "type": "User",
                                                                                                                  "site_admin": false
                                                                                                                },
                                                                                                                "repo": {
                                                                                                                  "id": 1296269,
                                                                                                                  "owner": {
                                                                                                                    "login": "octocat",
                                                                                                                    "id": 1,
                                                                                                                    "avatar_url": "https://github.com/images/error/octocat_happy.gif",
                                                                                                                    "gravatar_id": "",
                                                                                                                    "url": "https://api.github.com/users/octocat",
                                                                                                                    "html_url": "https://github.com/octocat",
                                                                                                                    "followers_url": "https://api.github.com/users/octocat/followers",
                                                                                                                    "following_url": "https://api.github.com/users/octocat/following{/other_user}",
                                                                                                                    "gists_url": "https://api.github.com/users/octocat/gists{/gist_id}",
                                                                                                                    "starred_url": "https://api.github.com/users/octocat/starred{/owner}{/repo}",
                                                                                                                    "subscriptions_url": "https://api.github.com/users/octocat/subscriptions",
                                                                                                                    "organizations_url": "https://api.github.com/users/octocat/orgs",
                                                                                                                    "repos_url": "https://api.github.com/users/octocat/repos",
                                                                                                                    "events_url": "https://api.github.com/users/octocat/events{/privacy}",
                                                                                                                    "received_events_url": "https://api.github.com/users/octocat/received_events",
                                                                                                                    "type": "User",
                                                                                                                    "site_admin": false
                                                                                                                  },
                                                                                                                  "name": "Hello-World",
                                                                                                                  "full_name": "octocat/Hello-World",
                                                                                                                  "description": "This your first repo!",
                                                                                                                  "private": false,
                                                                                                                  "fork": false,
                                                                                                                  "url": "https://api.github.com/repos/octocat/Hello-World",
                                                                                                                  "html_url": "https://github.com/octocat/Hello-World",
                                                                                                                  "archive_url": "http://api.github.com/repos/octocat/Hello-World/{archive_format}{/ref}",
                                                                                                                  "assignees_url": "http://api.github.com/repos/octocat/Hello-World/assignees{/user}",
                                                                                                                  "blobs_url": "http://api.github.com/repos/octocat/Hello-World/git/blobs{/sha}",
                                                                                                                  "branches_url": "http://api.github.com/repos/octocat/Hello-World/branches{/branch}",
                                                                                                                  "clone_url": "https://github.com/octocat/Hello-World.git",
                                                                                                                  "collaborators_url": "http://api.github.com/repos/octocat/Hello-World/collaborators{/collaborator}",
                                                                                                                  "comments_url": "http://api.github.com/repos/octocat/Hello-World/comments{/number}",
                                                                                                                  "commits_url": "http://api.github.com/repos/octocat/Hello-World/commits{/sha}",
                                                                                                                  "compare_url": "http://api.github.com/repos/octocat/Hello-World/compare/{base}...{head}",
                                                                                                                  "contents_url": "http://api.github.com/repos/octocat/Hello-World/contents/{+path}",
                                                                                                                  "contributors_url": "http://api.github.com/repos/octocat/Hello-World/contributors",
                                                                                                                  "deployments_url": "http://api.github.com/repos/octocat/Hello-World/deployments",
                                                                                                                  "downloads_url": "http://api.github.com/repos/octocat/Hello-World/downloads",
                                                                                                                  "events_url": "http://api.github.com/repos/octocat/Hello-World/events",
                                                                                                                  "forks_url": "http://api.github.com/repos/octocat/Hello-World/forks",
                                                                                                                  "git_commits_url": "http://api.github.com/repos/octocat/Hello-World/git/commits{/sha}",
                                                                                                                  "git_refs_url": "http://api.github.com/repos/octocat/Hello-World/git/refs{/sha}",
                                                                                                                  "git_tags_url": "http://api.github.com/repos/octocat/Hello-World/git/tags{/sha}",
                                                                                                                  "git_url": "git:github.com/octocat/Hello-World.git",
                                                                                                                  "hooks_url": "http://api.github.com/repos/octocat/Hello-World/hooks",
                                                                                                                  "issue_comment_url": "http://api.github.com/repos/octocat/Hello-World/issues/comments{/number}",
                                                                                                                  "issue_events_url": "http://api.github.com/repos/octocat/Hello-World/issues/events{/number}",
                                                                                                                  "issues_url": "http://api.github.com/repos/octocat/Hello-World/issues{/number}",
                                                                                                                  "keys_url": "http://api.github.com/repos/octocat/Hello-World/keys{/key_id}",
                                                                                                                  "labels_url": "http://api.github.com/repos/octocat/Hello-World/labels{/name}",
                                                                                                                  "languages_url": "http://api.github.com/repos/octocat/Hello-World/languages",
                                                                                                                  "merges_url": "http://api.github.com/repos/octocat/Hello-World/merges",
                                                                                                                  "milestones_url": "http://api.github.com/repos/octocat/Hello-World/milestones{/number}",
                                                                                                                  "mirror_url": "git:git.example.com/octocat/Hello-World",
                                                                                                                  "notifications_url": "http://api.github.com/repos/octocat/Hello-World/notifications{?since,all,participating}",
                                                                                                                  "pulls_url": "http://api.github.com/repos/octocat/Hello-World/pulls{/number}",
                                                                                                                  "releases_url": "http://api.github.com/repos/octocat/Hello-World/releases{/id}",
                                                                                                                  "ssh_url": "git@github.com:octocat/Hello-World.git",
                                                                                                                  "stargazers_url": "http://api.github.com/repos/octocat/Hello-World/stargazers",
                                                                                                                  "statuses_url": "http://api.github.com/repos/octocat/Hello-World/statuses/{sha}",
                                                                                                                  "subscribers_url": "http://api.github.com/repos/octocat/Hello-World/subscribers",
                                                                                                                  "subscription_url": "http://api.github.com/repos/octocat/Hello-World/subscription",
                                                                                                                  "svn_url": "https://svn.github.com/octocat/Hello-World",
                                                                                                                  "tags_url": "http://api.github.com/repos/octocat/Hello-World/tags",
                                                                                                                  "teams_url": "http://api.github.com/repos/octocat/Hello-World/teams",
                                                                                                                  "trees_url": "http://api.github.com/repos/octocat/Hello-World/git/trees{/sha}",
                                                                                                                  "homepage": "https://github.com",
                                                                                                                  "language": null,
                                                                                                                  "forks_count": 9,
                                                                                                                  "stargazers_count": 80,
                                                                                                                  "watchers_count": 80,
                                                                                                                  "size": 108,
                                                                                                                  "default_branch": "master",
                                                                                                                  "open_issues_count": 0,
                                                                                                                  "topics": [
                                                                                                                    "octocat",
                                                                                                                    "atom",
                                                                                                                    "electron",
                                                                                                                    "API"
                                                                                                                  ],
                                                                                                                  "has_issues": true,
                                                                                                                  "has_wiki": true,
                                                                                                                  "has_pages": false,
                                                                                                                  "has_downloads": true,
                                                                                                                  "archived": false,
                                                                                                                  "pushed_at": "2011-01-26T19:06:43Z",
                                                                                                                  "created_at": "2011-01-26T19:01:12Z",
                                                                                                                  "updated_at": "2011-01-26T19:14:43Z",
                                                                                                                  "permissions": {
                                                                                                                    "admin": false,
                                                                                                                    "push": false,
                                                                                                                    "pull": true
                                                                                                                  },
                                                                                                                  "allow_rebase_merge": true,
                                                                                                                  "allow_squash_merge": true,
                                                                                                                  "allow_merge_commit": true,
                                                                                                                  "subscribers_count": 42,
                                                                                                                  "network_count": 0
                                                                                                                }
                                                                                                              },
                                                                                                              "_links": {
                                                                                                                "self": {
                                                                                                                  "href": "https://api.github.com/repos/octocat/Hello-World/pulls/1347"
                                                                                                                },
                                                                                                                "html": {
                                                                                                                  "href": "https://github.com/octocat/Hello-World/pull/1347"
                                                                                                                },
                                                                                                                "issue": {
                                                                                                                  "href": "https://api.github.com/repos/octocat/Hello-World/issues/1347"
                                                                                                                },
                                                                                                                "comments": {
                                                                                                                  "href": "https://api.github.com/repos/octocat/Hello-World/issues/1347/comments"
                                                                                                                },
                                                                                                                "review_comments": {
                                                                                                                  "href": "https://api.github.com/repos/octocat/Hello-World/pulls/1347/comments"
                                                                                                                },
                                                                                                                "review_comment": {
                                                                                                                  "href": "https://api.github.com/repos/octocat/Hello-World/pulls/comments{/number}"
                                                                                                                },
                                                                                                                "commits": {
                                                                                                                  "href": "https://api.github.com/repos/octocat/Hello-World/pulls/1347/commits"
                                                                                                                },
                                                                                                                "statuses": {
                                                                                                                  "href": "https://api.github.com/repos/octocat/Hello-World/statuses/6dcb09b5b57875f334f61aebed695e2e4193db5e"
                                                                                                                }
                                                                                                              },
                                                                                                              "user": {
                                                                                                                "login": "octocat",
                                                                                                                "id": 1,
                                                                                                                "avatar_url": "https://github.com/images/error/octocat_happy.gif",
                                                                                                                "gravatar_id": "",
                                                                                                                "url": "https://api.github.com/users/octocat",
                                                                                                                "html_url": "https://github.com/octocat",
                                                                                                                "followers_url": "https://api.github.com/users/octocat/followers",
                                                                                                                "following_url": "https://api.github.com/users/octocat/following{/other_user}",
                                                                                                                "gists_url": "https://api.github.com/users/octocat/gists{/gist_id}",
                                                                                                                "starred_url": "https://api.github.com/users/octocat/starred{/owner}{/repo}",
                                                                                                                "subscriptions_url": "https://api.github.com/users/octocat/subscriptions",
                                                                                                                "organizations_url": "https://api.github.com/users/octocat/orgs",
                                                                                                                "repos_url": "https://api.github.com/users/octocat/repos",
                                                                                                                "events_url": "https://api.github.com/users/octocat/events{/privacy}",
                                                                                                                "received_events_url": "https://api.github.com/users/octocat/received_events",
                                                                                                                "type": "User",
                                                                                                                "site_admin": false
                                                                                                              }
                                                                                                            }
                                                                                                          ]
                                                                                                          

                                                                                                          Get a single pull request

                                                                                                          GET /repos/:owner/:repo/pulls/:number
                                                                                                          

                                                                                                          Response

                                                                                                          Each time the pull request receives new commits, GitHub creates a merge commit to test whether the pull request can be automatically merged into the base branch. (This test commit is not added to the base branch or the head branch.)

                                                                                                          The value of the merge_commit_sha attribute changes depending on the state of the pull request. Before a pull request is merged, the merge_commit_sha attribute holds the SHA of the test merge commit. After a pull request is merged, the attribute changes depending on how the pull request was merged:

                                                                                                          • If the pull request was merged as a merge commit, the attribute represents the SHA of the merge commit.
                                                                                                          • If the pull request was merged via a squash, the attribute represents the SHA of the squashed commit on the base branch.
                                                                                                          • If the pull request was rebased, the attribute represents the commit that the base branch was updated to.

                                                                                                          The value of the mergeable attribute can be true, false, or null. If the value is null, this means that the mergeability hasn't been computed yet, and a background job was started to compute it. Give the job a few moments to complete, and then submit the request again. When the job is complete, the response will include a non-null value for the mergeable attribute.

                                                                                                          Pass the appropriate media type to fetch diff and patch formats.

                                                                                                          Status: 200 OK
                                                                                                          
                                                                                                          {
                                                                                                            "id": 1,
                                                                                                            "url": "https://api.github.com/repos/octocat/Hello-World/pulls/1347",
                                                                                                            "html_url": "https://github.com/octocat/Hello-World/pull/1347",
                                                                                                            "diff_url": "https://github.com/octocat/Hello-World/pull/1347.diff",
                                                                                                            "patch_url": "https://github.com/octocat/Hello-World/pull/1347.patch",
                                                                                                            "issue_url": "https://api.github.com/repos/octocat/Hello-World/issues/1347",
                                                                                                            "commits_url": "https://api.github.com/repos/octocat/Hello-World/pulls/1347/commits",
                                                                                                            "review_comments_url": "https://api.github.com/repos/octocat/Hello-World/pulls/1347/comments",
                                                                                                            "review_comment_url": "https://api.github.com/repos/octocat/Hello-World/pulls/comments{/number}",
                                                                                                            "comments_url": "https://api.github.com/repos/octocat/Hello-World/issues/1347/comments",
                                                                                                            "statuses_url": "https://api.github.com/repos/octocat/Hello-World/statuses/6dcb09b5b57875f334f61aebed695e2e4193db5e",
                                                                                                            "number": 1347,
                                                                                                            "state": "open",
                                                                                                            "title": "new-feature",
                                                                                                            "body": "Please pull these awesome changes",
                                                                                                            "assignee": {
                                                                                                              "login": "octocat",
                                                                                                              "id": 1,
                                                                                                              "avatar_url": "https://github.com/images/error/octocat_happy.gif",
                                                                                                              "gravatar_id": "",
                                                                                                              "url": "https://api.github.com/users/octocat",
                                                                                                              "html_url": "https://github.com/octocat",
                                                                                                              "followers_url": "https://api.github.com/users/octocat/followers",
                                                                                                              "following_url": "https://api.github.com/users/octocat/following{/other_user}",
                                                                                                              "gists_url": "https://api.github.com/users/octocat/gists{/gist_id}",
                                                                                                              "starred_url": "https://api.github.com/users/octocat/starred{/owner}{/repo}",
                                                                                                              "subscriptions_url": "https://api.github.com/users/octocat/subscriptions",
                                                                                                              "organizations_url": "https://api.github.com/users/octocat/orgs",
                                                                                                              "repos_url": "https://api.github.com/users/octocat/repos",
                                                                                                              "events_url": "https://api.github.com/users/octocat/events{/privacy}",
                                                                                                              "received_events_url": "https://api.github.com/users/octocat/received_events",
                                                                                                              "type": "User",
                                                                                                              "site_admin": false
                                                                                                            },
                                                                                                            "milestone": {
                                                                                                              "url": "https://api.github.com/repos/octocat/Hello-World/milestones/1",
                                                                                                              "html_url": "https://github.com/octocat/Hello-World/milestones/v1.0",
                                                                                                              "labels_url": "https://api.github.com/repos/octocat/Hello-World/milestones/1/labels",
                                                                                                              "id": 1002604,
                                                                                                              "number": 1,
                                                                                                              "state": "open",
                                                                                                              "title": "v1.0",
                                                                                                              "description": "Tracking milestone for version 1.0",
                                                                                                              "creator": {
                                                                                                                "login": "octocat",
                                                                                                                "id": 1,
                                                                                                                "avatar_url": "https://github.com/images/error/octocat_happy.gif",
                                                                                                                "gravatar_id": "",
                                                                                                                "url": "https://api.github.com/users/octocat",
                                                                                                                "html_url": "https://github.com/octocat",
                                                                                                                "followers_url": "https://api.github.com/users/octocat/followers",
                                                                                                                "following_url": "https://api.github.com/users/octocat/following{/other_user}",
                                                                                                                "gists_url": "https://api.github.com/users/octocat/gists{/gist_id}",
                                                                                                                "starred_url": "https://api.github.com/users/octocat/starred{/owner}{/repo}",
                                                                                                                "subscriptions_url": "https://api.github.com/users/octocat/subscriptions",
                                                                                                                "organizations_url": "https://api.github.com/users/octocat/orgs",
                                                                                                                "repos_url": "https://api.github.com/users/octocat/repos",
                                                                                                                "events_url": "https://api.github.com/users/octocat/events{/privacy}",
                                                                                                                "received_events_url": "https://api.github.com/users/octocat/received_events",
                                                                                                                "type": "User",
                                                                                                                "site_admin": false
                                                                                                              },
                                                                                                              "open_issues": 4,
                                                                                                              "closed_issues": 8,
                                                                                                              "created_at": "2011-04-10T20:09:31Z",
                                                                                                              "updated_at": "2014-03-03T18:58:10Z",
                                                                                                              "closed_at": "2013-02-12T13:22:01Z",
                                                                                                              "due_on": "2012-10-09T23:39:01Z"
                                                                                                            },
                                                                                                            "locked": true,
                                                                                                            "active_lock_reason": "too heated",
                                                                                                            "created_at": "2011-01-26T19:01:12Z",
                                                                                                            "updated_at": "2011-01-26T19:01:12Z",
                                                                                                            "closed_at": "2011-01-26T19:01:12Z",
                                                                                                            "merged_at": "2011-01-26T19:01:12Z",
                                                                                                            "head": {
                                                                                                              "label": "new-topic",
                                                                                                              "ref": "new-topic",
                                                                                                              "sha": "6dcb09b5b57875f334f61aebed695e2e4193db5e",
                                                                                                              "user": {
                                                                                                                "login": "octocat",
                                                                                                                "id": 1,
                                                                                                                "avatar_url": "https://github.com/images/error/octocat_happy.gif",
                                                                                                                "gravatar_id": "",
                                                                                                                "url": "https://api.github.com/users/octocat",
                                                                                                                "html_url": "https://github.com/octocat",
                                                                                                                "followers_url": "https://api.github.com/users/octocat/followers",
                                                                                                                "following_url": "https://api.github.com/users/octocat/following{/other_user}",
                                                                                                                "gists_url": "https://api.github.com/users/octocat/gists{/gist_id}",
                                                                                                                "starred_url": "https://api.github.com/users/octocat/starred{/owner}{/repo}",
                                                                                                                "subscriptions_url": "https://api.github.com/users/octocat/subscriptions",
                                                                                                                "organizations_url": "https://api.github.com/users/octocat/orgs",
                                                                                                                "repos_url": "https://api.github.com/users/octocat/repos",
                                                                                                                "events_url": "https://api.github.com/users/octocat/events{/privacy}",
                                                                                                                "received_events_url": "https://api.github.com/users/octocat/received_events",
                                                                                                                "type": "User",
                                                                                                                "site_admin": false
                                                                                                              },
                                                                                                              "repo": {
                                                                                                                "id": 1296269,
                                                                                                                "owner": {
                                                                                                                  "login": "octocat",
                                                                                                                  "id": 1,
                                                                                                                  "avatar_url": "https://github.com/images/error/octocat_happy.gif",
                                                                                                                  "gravatar_id": "",
                                                                                                                  "url": "https://api.github.com/users/octocat",
                                                                                                                  "html_url": "https://github.com/octocat",
                                                                                                                  "followers_url": "https://api.github.com/users/octocat/followers",
                                                                                                                  "following_url": "https://api.github.com/users/octocat/following{/other_user}",
                                                                                                                  "gists_url": "https://api.github.com/users/octocat/gists{/gist_id}",
                                                                                                                  "starred_url": "https://api.github.com/users/octocat/starred{/owner}{/repo}",
                                                                                                                  "subscriptions_url": "https://api.github.com/users/octocat/subscriptions",
                                                                                                                  "organizations_url": "https://api.github.com/users/octocat/orgs",
                                                                                                                  "repos_url": "https://api.github.com/users/octocat/repos",
                                                                                                                  "events_url": "https://api.github.com/users/octocat/events{/privacy}",
                                                                                                                  "received_events_url": "https://api.github.com/users/octocat/received_events",
                                                                                                                  "type": "User",
                                                                                                                  "site_admin": false
                                                                                                                },
                                                                                                                "name": "Hello-World",
                                                                                                                "full_name": "octocat/Hello-World",
                                                                                                                "description": "This your first repo!",
                                                                                                                "private": false,
                                                                                                                "fork": false,
                                                                                                                "url": "https://api.github.com/repos/octocat/Hello-World",
                                                                                                                "html_url": "https://github.com/octocat/Hello-World",
                                                                                                                "archive_url": "http://api.github.com/repos/octocat/Hello-World/{archive_format}{/ref}",
                                                                                                                "assignees_url": "http://api.github.com/repos/octocat/Hello-World/assignees{/user}",
                                                                                                                "blobs_url": "http://api.github.com/repos/octocat/Hello-World/git/blobs{/sha}",
                                                                                                                "branches_url": "http://api.github.com/repos/octocat/Hello-World/branches{/branch}",
                                                                                                                "clone_url": "https://github.com/octocat/Hello-World.git",
                                                                                                                "collaborators_url": "http://api.github.com/repos/octocat/Hello-World/collaborators{/collaborator}",
                                                                                                                "comments_url": "http://api.github.com/repos/octocat/Hello-World/comments{/number}",
                                                                                                                "commits_url": "http://api.github.com/repos/octocat/Hello-World/commits{/sha}",
                                                                                                                "compare_url": "http://api.github.com/repos/octocat/Hello-World/compare/{base}...{head}",
                                                                                                                "contents_url": "http://api.github.com/repos/octocat/Hello-World/contents/{+path}",
                                                                                                                "contributors_url": "http://api.github.com/repos/octocat/Hello-World/contributors",
                                                                                                                "deployments_url": "http://api.github.com/repos/octocat/Hello-World/deployments",
                                                                                                                "downloads_url": "http://api.github.com/repos/octocat/Hello-World/downloads",
                                                                                                                "events_url": "http://api.github.com/repos/octocat/Hello-World/events",
                                                                                                                "forks_url": "http://api.github.com/repos/octocat/Hello-World/forks",
                                                                                                                "git_commits_url": "http://api.github.com/repos/octocat/Hello-World/git/commits{/sha}",
                                                                                                                "git_refs_url": "http://api.github.com/repos/octocat/Hello-World/git/refs{/sha}",
                                                                                                                "git_tags_url": "http://api.github.com/repos/octocat/Hello-World/git/tags{/sha}",
                                                                                                                "git_url": "git:github.com/octocat/Hello-World.git",
                                                                                                                "hooks_url": "http://api.github.com/repos/octocat/Hello-World/hooks",
                                                                                                                "issue_comment_url": "http://api.github.com/repos/octocat/Hello-World/issues/comments{/number}",
                                                                                                                "issue_events_url": "http://api.github.com/repos/octocat/Hello-World/issues/events{/number}",
                                                                                                                "issues_url": "http://api.github.com/repos/octocat/Hello-World/issues{/number}",
                                                                                                                "keys_url": "http://api.github.com/repos/octocat/Hello-World/keys{/key_id}",
                                                                                                                "labels_url": "http://api.github.com/repos/octocat/Hello-World/labels{/name}",
                                                                                                                "languages_url": "http://api.github.com/repos/octocat/Hello-World/languages",
                                                                                                                "merges_url": "http://api.github.com/repos/octocat/Hello-World/merges",
                                                                                                                "milestones_url": "http://api.github.com/repos/octocat/Hello-World/milestones{/number}",
                                                                                                                "mirror_url": "git:git.example.com/octocat/Hello-World",
                                                                                                                "notifications_url": "http://api.github.com/repos/octocat/Hello-World/notifications{?since,all,participating}",
                                                                                                                "pulls_url": "http://api.github.com/repos/octocat/Hello-World/pulls{/number}",
                                                                                                                "releases_url": "http://api.github.com/repos/octocat/Hello-World/releases{/id}",
                                                                                                                "ssh_url": "git@github.com:octocat/Hello-World.git",
                                                                                                                "stargazers_url": "http://api.github.com/repos/octocat/Hello-World/stargazers",
                                                                                                                "statuses_url": "http://api.github.com/repos/octocat/Hello-World/statuses/{sha}",
                                                                                                                "subscribers_url": "http://api.github.com/repos/octocat/Hello-World/subscribers",
                                                                                                                "subscription_url": "http://api.github.com/repos/octocat/Hello-World/subscription",
                                                                                                                "svn_url": "https://svn.github.com/octocat/Hello-World",
                                                                                                                "tags_url": "http://api.github.com/repos/octocat/Hello-World/tags",
                                                                                                                "teams_url": "http://api.github.com/repos/octocat/Hello-World/teams",
                                                                                                                "trees_url": "http://api.github.com/repos/octocat/Hello-World/git/trees{/sha}",
                                                                                                                "homepage": "https://github.com",
                                                                                                                "language": null,
                                                                                                                "forks_count": 9,
                                                                                                                "stargazers_count": 80,
                                                                                                                "watchers_count": 80,
                                                                                                                "size": 108,
                                                                                                                "default_branch": "master",
                                                                                                                "open_issues_count": 0,
                                                                                                                "topics": [
                                                                                                                  "octocat",
                                                                                                                  "atom",
                                                                                                                  "electron",
                                                                                                                  "API"
                                                                                                                ],
                                                                                                                "has_issues": true,
                                                                                                                "has_wiki": true,
                                                                                                                "has_pages": false,
                                                                                                                "has_downloads": true,
                                                                                                                "archived": false,
                                                                                                                "pushed_at": "2011-01-26T19:06:43Z",
                                                                                                                "created_at": "2011-01-26T19:01:12Z",
                                                                                                                "updated_at": "2011-01-26T19:14:43Z",
                                                                                                                "permissions": {
                                                                                                                  "admin": false,
                                                                                                                  "push": false,
                                                                                                                  "pull": true
                                                                                                                },
                                                                                                                "allow_rebase_merge": true,
                                                                                                                "allow_squash_merge": true,
                                                                                                                "allow_merge_commit": true,
                                                                                                                "subscribers_count": 42,
                                                                                                                "network_count": 0
                                                                                                              }
                                                                                                            },
                                                                                                            "base": {
                                                                                                              "label": "master",
                                                                                                              "ref": "master",
                                                                                                              "sha": "6dcb09b5b57875f334f61aebed695e2e4193db5e",
                                                                                                              "user": {
                                                                                                                "login": "octocat",
                                                                                                                "id": 1,
                                                                                                                "avatar_url": "https://github.com/images/error/octocat_happy.gif",
                                                                                                                "gravatar_id": "",
                                                                                                                "url": "https://api.github.com/users/octocat",
                                                                                                                "html_url": "https://github.com/octocat",
                                                                                                                "followers_url": "https://api.github.com/users/octocat/followers",
                                                                                                                "following_url": "https://api.github.com/users/octocat/following{/other_user}",
                                                                                                                "gists_url": "https://api.github.com/users/octocat/gists{/gist_id}",
                                                                                                                "starred_url": "https://api.github.com/users/octocat/starred{/owner}{/repo}",
                                                                                                                "subscriptions_url": "https://api.github.com/users/octocat/subscriptions",
                                                                                                                "organizations_url": "https://api.github.com/users/octocat/orgs",
                                                                                                                "repos_url": "https://api.github.com/users/octocat/repos",
                                                                                                                "events_url": "https://api.github.com/users/octocat/events{/privacy}",
                                                                                                                "received_events_url": "https://api.github.com/users/octocat/received_events",
                                                                                                                "type": "User",
                                                                                                                "site_admin": false
                                                                                                              },
                                                                                                              "repo": {
                                                                                                                "id": 1296269,
                                                                                                                "owner": {
                                                                                                                  "login": "octocat",
                                                                                                                  "id": 1,
                                                                                                                  "avatar_url": "https://github.com/images/error/octocat_happy.gif",
                                                                                                                  "gravatar_id": "",
                                                                                                                  "url": "https://api.github.com/users/octocat",
                                                                                                                  "html_url": "https://github.com/octocat",
                                                                                                                  "followers_url": "https://api.github.com/users/octocat/followers",
                                                                                                                  "following_url": "https://api.github.com/users/octocat/following{/other_user}",
                                                                                                                  "gists_url": "https://api.github.com/users/octocat/gists{/gist_id}",
                                                                                                                  "starred_url": "https://api.github.com/users/octocat/starred{/owner}{/repo}",
                                                                                                                  "subscriptions_url": "https://api.github.com/users/octocat/subscriptions",
                                                                                                                  "organizations_url": "https://api.github.com/users/octocat/orgs",
                                                                                                                  "repos_url": "https://api.github.com/users/octocat/repos",
                                                                                                                  "events_url": "https://api.github.com/users/octocat/events{/privacy}",
                                                                                                                  "received_events_url": "https://api.github.com/users/octocat/received_events",
                                                                                                                  "type": "User",
                                                                                                                  "site_admin": false
                                                                                                                },
                                                                                                                "name": "Hello-World",
                                                                                                                "full_name": "octocat/Hello-World",
                                                                                                                "description": "This your first repo!",
                                                                                                                "private": false,
                                                                                                                "fork": false,
                                                                                                                "url": "https://api.github.com/repos/octocat/Hello-World",
                                                                                                                "html_url": "https://github.com/octocat/Hello-World",
                                                                                                                "archive_url": "http://api.github.com/repos/octocat/Hello-World/{archive_format}{/ref}",
                                                                                                                "assignees_url": "http://api.github.com/repos/octocat/Hello-World/assignees{/user}",
                                                                                                                "blobs_url": "http://api.github.com/repos/octocat/Hello-World/git/blobs{/sha}",
                                                                                                                "branches_url": "http://api.github.com/repos/octocat/Hello-World/branches{/branch}",
                                                                                                                "clone_url": "https://github.com/octocat/Hello-World.git",
                                                                                                                "collaborators_url": "http://api.github.com/repos/octocat/Hello-World/collaborators{/collaborator}",
                                                                                                                "comments_url": "http://api.github.com/repos/octocat/Hello-World/comments{/number}",
                                                                                                                "commits_url": "http://api.github.com/repos/octocat/Hello-World/commits{/sha}",
                                                                                                                "compare_url": "http://api.github.com/repos/octocat/Hello-World/compare/{base}...{head}",
                                                                                                                "contents_url": "http://api.github.com/repos/octocat/Hello-World/contents/{+path}",
                                                                                                                "contributors_url": "http://api.github.com/repos/octocat/Hello-World/contributors",
                                                                                                                "deployments_url": "http://api.github.com/repos/octocat/Hello-World/deployments",
                                                                                                                "downloads_url": "http://api.github.com/repos/octocat/Hello-World/downloads",
                                                                                                                "events_url": "http://api.github.com/repos/octocat/Hello-World/events",
                                                                                                                "forks_url": "http://api.github.com/repos/octocat/Hello-World/forks",
                                                                                                                "git_commits_url": "http://api.github.com/repos/octocat/Hello-World/git/commits{/sha}",
                                                                                                                "git_refs_url": "http://api.github.com/repos/octocat/Hello-World/git/refs{/sha}",
                                                                                                                "git_tags_url": "http://api.github.com/repos/octocat/Hello-World/git/tags{/sha}",
                                                                                                                "git_url": "git:github.com/octocat/Hello-World.git",
                                                                                                                "hooks_url": "http://api.github.com/repos/octocat/Hello-World/hooks",
                                                                                                                "issue_comment_url": "http://api.github.com/repos/octocat/Hello-World/issues/comments{/number}",
                                                                                                                "issue_events_url": "http://api.github.com/repos/octocat/Hello-World/issues/events{/number}",
                                                                                                                "issues_url": "http://api.github.com/repos/octocat/Hello-World/issues{/number}",
                                                                                                                "keys_url": "http://api.github.com/repos/octocat/Hello-World/keys{/key_id}",
                                                                                                                "labels_url": "http://api.github.com/repos/octocat/Hello-World/labels{/name}",
                                                                                                                "languages_url": "http://api.github.com/repos/octocat/Hello-World/languages",
                                                                                                                "merges_url": "http://api.github.com/repos/octocat/Hello-World/merges",
                                                                                                                "milestones_url": "http://api.github.com/repos/octocat/Hello-World/milestones{/number}",
                                                                                                                "mirror_url": "git:git.example.com/octocat/Hello-World",
                                                                                                                "notifications_url": "http://api.github.com/repos/octocat/Hello-World/notifications{?since,all,participating}",
                                                                                                                "pulls_url": "http://api.github.com/repos/octocat/Hello-World/pulls{/number}",
                                                                                                                "releases_url": "http://api.github.com/repos/octocat/Hello-World/releases{/id}",
                                                                                                                "ssh_url": "git@github.com:octocat/Hello-World.git",
                                                                                                                "stargazers_url": "http://api.github.com/repos/octocat/Hello-World/stargazers",
                                                                                                                "statuses_url": "http://api.github.com/repos/octocat/Hello-World/statuses/{sha}",
                                                                                                                "subscribers_url": "http://api.github.com/repos/octocat/Hello-World/subscribers",
                                                                                                                "subscription_url": "http://api.github.com/repos/octocat/Hello-World/subscription",
                                                                                                                "svn_url": "https://svn.github.com/octocat/Hello-World",
                                                                                                                "tags_url": "http://api.github.com/repos/octocat/Hello-World/tags",
                                                                                                                "teams_url": "http://api.github.com/repos/octocat/Hello-World/teams",
                                                                                                                "trees_url": "http://api.github.com/repos/octocat/Hello-World/git/trees{/sha}",
                                                                                                                "homepage": "https://github.com",
                                                                                                                "language": null,
                                                                                                                "forks_count": 9,
                                                                                                                "stargazers_count": 80,
                                                                                                                "watchers_count": 80,
                                                                                                                "size": 108,
                                                                                                                "default_branch": "master",
                                                                                                                "open_issues_count": 0,
                                                                                                                "topics": [
                                                                                                                  "octocat",
                                                                                                                  "atom",
                                                                                                                  "electron",
                                                                                                                  "API"
                                                                                                                ],
                                                                                                                "has_issues": true,
                                                                                                                "has_wiki": true,
                                                                                                                "has_pages": false,
                                                                                                                "has_downloads": true,
                                                                                                                "archived": false,
                                                                                                                "pushed_at": "2011-01-26T19:06:43Z",
                                                                                                                "created_at": "2011-01-26T19:01:12Z",
                                                                                                                "updated_at": "2011-01-26T19:14:43Z",
                                                                                                                "permissions": {
                                                                                                                  "admin": false,
                                                                                                                  "push": false,
                                                                                                                  "pull": true
                                                                                                                },
                                                                                                                "allow_rebase_merge": true,
                                                                                                                "allow_squash_merge": true,
                                                                                                                "allow_merge_commit": true,
                                                                                                                "subscribers_count": 42,
                                                                                                                "network_count": 0
                                                                                                              }
                                                                                                            },
                                                                                                            "_links": {
                                                                                                              "self": {
                                                                                                                "href": "https://api.github.com/repos/octocat/Hello-World/pulls/1347"
                                                                                                              },
                                                                                                              "html": {
                                                                                                                "href": "https://github.com/octocat/Hello-World/pull/1347"
                                                                                                              },
                                                                                                              "issue": {
                                                                                                                "href": "https://api.github.com/repos/octocat/Hello-World/issues/1347"
                                                                                                              },
                                                                                                              "comments": {
                                                                                                                "href": "https://api.github.com/repos/octocat/Hello-World/issues/1347/comments"
                                                                                                              },
                                                                                                              "review_comments": {
                                                                                                                "href": "https://api.github.com/repos/octocat/Hello-World/pulls/1347/comments"
                                                                                                              },
                                                                                                              "review_comment": {
                                                                                                                "href": "https://api.github.com/repos/octocat/Hello-World/pulls/comments{/number}"
                                                                                                              },
                                                                                                              "commits": {
                                                                                                                "href": "https://api.github.com/repos/octocat/Hello-World/pulls/1347/commits"
                                                                                                              },
                                                                                                              "statuses": {
                                                                                                                "href": "https://api.github.com/repos/octocat/Hello-World/statuses/6dcb09b5b57875f334f61aebed695e2e4193db5e"
                                                                                                              }
                                                                                                            },
                                                                                                            "user": {
                                                                                                              "login": "octocat",
                                                                                                              "id": 1,
                                                                                                              "avatar_url": "https://github.com/images/error/octocat_happy.gif",
                                                                                                              "gravatar_id": "",
                                                                                                              "url": "https://api.github.com/users/octocat",
                                                                                                              "html_url": "https://github.com/octocat",
                                                                                                              "followers_url": "https://api.github.com/users/octocat/followers",
                                                                                                              "following_url": "https://api.github.com/users/octocat/following{/other_user}",
                                                                                                              "gists_url": "https://api.github.com/users/octocat/gists{/gist_id}",
                                                                                                              "starred_url": "https://api.github.com/users/octocat/starred{/owner}{/repo}",
                                                                                                              "subscriptions_url": "https://api.github.com/users/octocat/subscriptions",
                                                                                                              "organizations_url": "https://api.github.com/users/octocat/orgs",
                                                                                                              "repos_url": "https://api.github.com/users/octocat/repos",
                                                                                                              "events_url": "https://api.github.com/users/octocat/events{/privacy}",
                                                                                                              "received_events_url": "https://api.github.com/users/octocat/received_events",
                                                                                                              "type": "User",
                                                                                                              "site_admin": false
                                                                                                            },
                                                                                                            "merge_commit_sha": "e5bd3914e2e596debea16f433f57875b5b90bcd6",
                                                                                                            "merged": false,
                                                                                                            "mergeable": true,
                                                                                                            "merged_by": {
                                                                                                              "login": "octocat",
                                                                                                              "id": 1,
                                                                                                              "avatar_url": "https://github.com/images/error/octocat_happy.gif",
                                                                                                              "gravatar_id": "",
                                                                                                              "url": "https://api.github.com/users/octocat",
                                                                                                              "html_url": "https://github.com/octocat",
                                                                                                              "followers_url": "https://api.github.com/users/octocat/followers",
                                                                                                              "following_url": "https://api.github.com/users/octocat/following{/other_user}",
                                                                                                              "gists_url": "https://api.github.com/users/octocat/gists{/gist_id}",
                                                                                                              "starred_url": "https://api.github.com/users/octocat/starred{/owner}{/repo}",
                                                                                                              "subscriptions_url": "https://api.github.com/users/octocat/subscriptions",
                                                                                                              "organizations_url": "https://api.github.com/users/octocat/orgs",
                                                                                                              "repos_url": "https://api.github.com/users/octocat/repos",
                                                                                                              "events_url": "https://api.github.com/users/octocat/events{/privacy}",
                                                                                                              "received_events_url": "https://api.github.com/users/octocat/received_events",
                                                                                                              "type": "User",
                                                                                                              "site_admin": false
                                                                                                            },
                                                                                                            "comments": 10,
                                                                                                            "commits": 3,
                                                                                                            "additions": 100,
                                                                                                            "deletions": 3,
                                                                                                            "changed_files": 5,
                                                                                                            "maintainer_can_modify": true
                                                                                                          }
                                                                                                          

                                                                                                          Create a pull request

                                                                                                          POST /repos/:owner/:repo/pulls
                                                                                                          

                                                                                                          Input

                                                                                                          Name Type Description
                                                                                                          title string Required. The title of the pull request.
                                                                                                          head string Required. The name of the branch where your changes are implemented. For cross-repository pull requests in the same network, namespace head with a user like this: username:branch.
                                                                                                          base string Required. The name of the branch you want the changes pulled into. This should be an existing branch on the current repository. You cannot submit a pull request to one repository that requests a merge to a base of another repository.
                                                                                                          body string The contents of the pull request.
                                                                                                          maintainer_can_modify boolean Indicates whether maintainers can modify the pull request.

                                                                                                          Example

                                                                                                          {
                                                                                                            "title": "Amazing new feature",
                                                                                                            "body": "Please pull this in!",
                                                                                                            "head": "octocat:new-feature",
                                                                                                            "base": "master"
                                                                                                          }
                                                                                                          

                                                                                                          Alternative Input

                                                                                                          You can also create a Pull Request from an existing Issue by passing an Issue number instead of title and body.

                                                                                                          Name Type Description
                                                                                                          issue integer Required. The issue number in this repository to turn into a Pull Request.

                                                                                                          Example

                                                                                                          {
                                                                                                            "issue": 5,
                                                                                                            "head": "octocat:new-feature",
                                                                                                            "base": "master"
                                                                                                          }
                                                                                                          

                                                                                                          Response

                                                                                                          Status: 201 Created
                                                                                                          Location: https://api.github.com/repos/octocat/Hello-World/pulls/1347
                                                                                                          
                                                                                                          {
                                                                                                            "id": 1,
                                                                                                            "url": "https://api.github.com/repos/octocat/Hello-World/pulls/1347",
                                                                                                            "html_url": "https://github.com/octocat/Hello-World/pull/1347",
                                                                                                            "diff_url": "https://github.com/octocat/Hello-World/pull/1347.diff",
                                                                                                            "patch_url": "https://github.com/octocat/Hello-World/pull/1347.patch",
                                                                                                            "issue_url": "https://api.github.com/repos/octocat/Hello-World/issues/1347",
                                                                                                            "commits_url": "https://api.github.com/repos/octocat/Hello-World/pulls/1347/commits",
                                                                                                            "review_comments_url": "https://api.github.com/repos/octocat/Hello-World/pulls/1347/comments",
                                                                                                            "review_comment_url": "https://api.github.com/repos/octocat/Hello-World/pulls/comments{/number}",
                                                                                                            "comments_url": "https://api.github.com/repos/octocat/Hello-World/issues/1347/comments",
                                                                                                            "statuses_url": "https://api.github.com/repos/octocat/Hello-World/statuses/6dcb09b5b57875f334f61aebed695e2e4193db5e",
                                                                                                            "number": 1347,
                                                                                                            "state": "open",
                                                                                                            "title": "new-feature",
                                                                                                            "body": "Please pull these awesome changes",
                                                                                                            "assignee": {
                                                                                                              "login": "octocat",
                                                                                                              "id": 1,
                                                                                                              "avatar_url": "https://github.com/images/error/octocat_happy.gif",
                                                                                                              "gravatar_id": "",
                                                                                                              "url": "https://api.github.com/users/octocat",
                                                                                                              "html_url": "https://github.com/octocat",
                                                                                                              "followers_url": "https://api.github.com/users/octocat/followers",
                                                                                                              "following_url": "https://api.github.com/users/octocat/following{/other_user}",
                                                                                                              "gists_url": "https://api.github.com/users/octocat/gists{/gist_id}",
                                                                                                              "starred_url": "https://api.github.com/users/octocat/starred{/owner}{/repo}",
                                                                                                              "subscriptions_url": "https://api.github.com/users/octocat/subscriptions",
                                                                                                              "organizations_url": "https://api.github.com/users/octocat/orgs",
                                                                                                              "repos_url": "https://api.github.com/users/octocat/repos",
                                                                                                              "events_url": "https://api.github.com/users/octocat/events{/privacy}",
                                                                                                              "received_events_url": "https://api.github.com/users/octocat/received_events",
                                                                                                              "type": "User",
                                                                                                              "site_admin": false
                                                                                                            },
                                                                                                            "milestone": {
                                                                                                              "url": "https://api.github.com/repos/octocat/Hello-World/milestones/1",
                                                                                                              "html_url": "https://github.com/octocat/Hello-World/milestones/v1.0",
                                                                                                              "labels_url": "https://api.github.com/repos/octocat/Hello-World/milestones/1/labels",
                                                                                                              "id": 1002604,
                                                                                                              "number": 1,
                                                                                                              "state": "open",
                                                                                                              "title": "v1.0",
                                                                                                              "description": "Tracking milestone for version 1.0",
                                                                                                              "creator": {
                                                                                                                "login": "octocat",
                                                                                                                "id": 1,
                                                                                                                "avatar_url": "https://github.com/images/error/octocat_happy.gif",
                                                                                                                "gravatar_id": "",
                                                                                                                "url": "https://api.github.com/users/octocat",
                                                                                                                "html_url": "https://github.com/octocat",
                                                                                                                "followers_url": "https://api.github.com/users/octocat/followers",
                                                                                                                "following_url": "https://api.github.com/users/octocat/following{/other_user}",
                                                                                                                "gists_url": "https://api.github.com/users/octocat/gists{/gist_id}",
                                                                                                                "starred_url": "https://api.github.com/users/octocat/starred{/owner}{/repo}",
                                                                                                                "subscriptions_url": "https://api.github.com/users/octocat/subscriptions",
                                                                                                                "organizations_url": "https://api.github.com/users/octocat/orgs",
                                                                                                                "repos_url": "https://api.github.com/users/octocat/repos",
                                                                                                                "events_url": "https://api.github.com/users/octocat/events{/privacy}",
                                                                                                                "received_events_url": "https://api.github.com/users/octocat/received_events",
                                                                                                                "type": "User",
                                                                                                                "site_admin": false
                                                                                                              },
                                                                                                              "open_issues": 4,
                                                                                                              "closed_issues": 8,
                                                                                                              "created_at": "2011-04-10T20:09:31Z",
                                                                                                              "updated_at": "2014-03-03T18:58:10Z",
                                                                                                              "closed_at": "2013-02-12T13:22:01Z",
                                                                                                              "due_on": "2012-10-09T23:39:01Z"
                                                                                                            },
                                                                                                            "locked": true,
                                                                                                            "active_lock_reason": "too heated",
                                                                                                            "created_at": "2011-01-26T19:01:12Z",
                                                                                                            "updated_at": "2011-01-26T19:01:12Z",
                                                                                                            "closed_at": "2011-01-26T19:01:12Z",
                                                                                                            "merged_at": "2011-01-26T19:01:12Z",
                                                                                                            "head": {
                                                                                                              "label": "new-topic",
                                                                                                              "ref": "new-topic",
                                                                                                              "sha": "6dcb09b5b57875f334f61aebed695e2e4193db5e",
                                                                                                              "user": {
                                                                                                                "login": "octocat",
                                                                                                                "id": 1,
                                                                                                                "avatar_url": "https://github.com/images/error/octocat_happy.gif",
                                                                                                                "gravatar_id": "",
                                                                                                                "url": "https://api.github.com/users/octocat",
                                                                                                                "html_url": "https://github.com/octocat",
                                                                                                                "followers_url": "https://api.github.com/users/octocat/followers",
                                                                                                                "following_url": "https://api.github.com/users/octocat/following{/other_user}",
                                                                                                                "gists_url": "https://api.github.com/users/octocat/gists{/gist_id}",
                                                                                                                "starred_url": "https://api.github.com/users/octocat/starred{/owner}{/repo}",
                                                                                                                "subscriptions_url": "https://api.github.com/users/octocat/subscriptions",
                                                                                                                "organizations_url": "https://api.github.com/users/octocat/orgs",
                                                                                                                "repos_url": "https://api.github.com/users/octocat/repos",
                                                                                                                "events_url": "https://api.github.com/users/octocat/events{/privacy}",
                                                                                                                "received_events_url": "https://api.github.com/users/octocat/received_events",
                                                                                                                "type": "User",
                                                                                                                "site_admin": false
                                                                                                              },
                                                                                                              "repo": {
                                                                                                                "id": 1296269,
                                                                                                                "owner": {
                                                                                                                  "login": "octocat",
                                                                                                                  "id": 1,
                                                                                                                  "avatar_url": "https://github.com/images/error/octocat_happy.gif",
                                                                                                                  "gravatar_id": "",
                                                                                                                  "url": "https://api.github.com/users/octocat",
                                                                                                                  "html_url": "https://github.com/octocat",
                                                                                                                  "followers_url": "https://api.github.com/users/octocat/followers",
                                                                                                                  "following_url": "https://api.github.com/users/octocat/following{/other_user}",
                                                                                                                  "gists_url": "https://api.github.com/users/octocat/gists{/gist_id}",
                                                                                                                  "starred_url": "https://api.github.com/users/octocat/starred{/owner}{/repo}",
                                                                                                                  "subscriptions_url": "https://api.github.com/users/octocat/subscriptions",
                                                                                                                  "organizations_url": "https://api.github.com/users/octocat/orgs",
                                                                                                                  "repos_url": "https://api.github.com/users/octocat/repos",
                                                                                                                  "events_url": "https://api.github.com/users/octocat/events{/privacy}",
                                                                                                                  "received_events_url": "https://api.github.com/users/octocat/received_events",
                                                                                                                  "type": "User",
                                                                                                                  "site_admin": false
                                                                                                                },
                                                                                                                "name": "Hello-World",
                                                                                                                "full_name": "octocat/Hello-World",
                                                                                                                "description": "This your first repo!",
                                                                                                                "private": false,
                                                                                                                "fork": false,
                                                                                                                "url": "https://api.github.com/repos/octocat/Hello-World",
                                                                                                                "html_url": "https://github.com/octocat/Hello-World",
                                                                                                                "archive_url": "http://api.github.com/repos/octocat/Hello-World/{archive_format}{/ref}",
                                                                                                                "assignees_url": "http://api.github.com/repos/octocat/Hello-World/assignees{/user}",
                                                                                                                "blobs_url": "http://api.github.com/repos/octocat/Hello-World/git/blobs{/sha}",
                                                                                                                "branches_url": "http://api.github.com/repos/octocat/Hello-World/branches{/branch}",
                                                                                                                "clone_url": "https://github.com/octocat/Hello-World.git",
                                                                                                                "collaborators_url": "http://api.github.com/repos/octocat/Hello-World/collaborators{/collaborator}",
                                                                                                                "comments_url": "http://api.github.com/repos/octocat/Hello-World/comments{/number}",
                                                                                                                "commits_url": "http://api.github.com/repos/octocat/Hello-World/commits{/sha}",
                                                                                                                "compare_url": "http://api.github.com/repos/octocat/Hello-World/compare/{base}...{head}",
                                                                                                                "contents_url": "http://api.github.com/repos/octocat/Hello-World/contents/{+path}",
                                                                                                                "contributors_url": "http://api.github.com/repos/octocat/Hello-World/contributors",
                                                                                                                "deployments_url": "http://api.github.com/repos/octocat/Hello-World/deployments",
                                                                                                                "downloads_url": "http://api.github.com/repos/octocat/Hello-World/downloads",
                                                                                                                "events_url": "http://api.github.com/repos/octocat/Hello-World/events",
                                                                                                                "forks_url": "http://api.github.com/repos/octocat/Hello-World/forks",
                                                                                                                "git_commits_url": "http://api.github.com/repos/octocat/Hello-World/git/commits{/sha}",
                                                                                                                "git_refs_url": "http://api.github.com/repos/octocat/Hello-World/git/refs{/sha}",
                                                                                                                "git_tags_url": "http://api.github.com/repos/octocat/Hello-World/git/tags{/sha}",
                                                                                                                "git_url": "git:github.com/octocat/Hello-World.git",
                                                                                                                "hooks_url": "http://api.github.com/repos/octocat/Hello-World/hooks",
                                                                                                                "issue_comment_url": "http://api.github.com/repos/octocat/Hello-World/issues/comments{/number}",
                                                                                                                "issue_events_url": "http://api.github.com/repos/octocat/Hello-World/issues/events{/number}",
                                                                                                                "issues_url": "http://api.github.com/repos/octocat/Hello-World/issues{/number}",
                                                                                                                "keys_url": "http://api.github.com/repos/octocat/Hello-World/keys{/key_id}",
                                                                                                                "labels_url": "http://api.github.com/repos/octocat/Hello-World/labels{/name}",
                                                                                                                "languages_url": "http://api.github.com/repos/octocat/Hello-World/languages",
                                                                                                                "merges_url": "http://api.github.com/repos/octocat/Hello-World/merges",
                                                                                                                "milestones_url": "http://api.github.com/repos/octocat/Hello-World/milestones{/number}",
                                                                                                                "mirror_url": "git:git.example.com/octocat/Hello-World",
                                                                                                                "notifications_url": "http://api.github.com/repos/octocat/Hello-World/notifications{?since,all,participating}",
                                                                                                                "pulls_url": "http://api.github.com/repos/octocat/Hello-World/pulls{/number}",
                                                                                                                "releases_url": "http://api.github.com/repos/octocat/Hello-World/releases{/id}",
                                                                                                                "ssh_url": "git@github.com:octocat/Hello-World.git",
                                                                                                                "stargazers_url": "http://api.github.com/repos/octocat/Hello-World/stargazers",
                                                                                                                "statuses_url": "http://api.github.com/repos/octocat/Hello-World/statuses/{sha}",
                                                                                                                "subscribers_url": "http://api.github.com/repos/octocat/Hello-World/subscribers",
                                                                                                                "subscription_url": "http://api.github.com/repos/octocat/Hello-World/subscription",
                                                                                                                "svn_url": "https://svn.github.com/octocat/Hello-World",
                                                                                                                "tags_url": "http://api.github.com/repos/octocat/Hello-World/tags",
                                                                                                                "teams_url": "http://api.github.com/repos/octocat/Hello-World/teams",
                                                                                                                "trees_url": "http://api.github.com/repos/octocat/Hello-World/git/trees{/sha}",
                                                                                                                "homepage": "https://github.com",
                                                                                                                "language": null,
                                                                                                                "forks_count": 9,
                                                                                                                "stargazers_count": 80,
                                                                                                                "watchers_count": 80,
                                                                                                                "size": 108,
                                                                                                                "default_branch": "master",
                                                                                                                "open_issues_count": 0,
                                                                                                                "topics": [
                                                                                                                  "octocat",
                                                                                                                  "atom",
                                                                                                                  "electron",
                                                                                                                  "API"
                                                                                                                ],
                                                                                                                "has_issues": true,
                                                                                                                "has_wiki": true,
                                                                                                                "has_pages": false,
                                                                                                                "has_downloads": true,
                                                                                                                "archived": false,
                                                                                                                "pushed_at": "2011-01-26T19:06:43Z",
                                                                                                                "created_at": "2011-01-26T19:01:12Z",
                                                                                                                "updated_at": "2011-01-26T19:14:43Z",
                                                                                                                "permissions": {
                                                                                                                  "admin": false,
                                                                                                                  "push": false,
                                                                                                                  "pull": true
                                                                                                                },
                                                                                                                "allow_rebase_merge": true,
                                                                                                                "allow_squash_merge": true,
                                                                                                                "allow_merge_commit": true,
                                                                                                                "subscribers_count": 42,
                                                                                                                "network_count": 0
                                                                                                              }
                                                                                                            },
                                                                                                            "base": {
                                                                                                              "label": "master",
                                                                                                              "ref": "master",
                                                                                                              "sha": "6dcb09b5b57875f334f61aebed695e2e4193db5e",
                                                                                                              "user": {
                                                                                                                "login": "octocat",
                                                                                                                "id": 1,
                                                                                                                "avatar_url": "https://github.com/images/error/octocat_happy.gif",
                                                                                                                "gravatar_id": "",
                                                                                                                "url": "https://api.github.com/users/octocat",
                                                                                                                "html_url": "https://github.com/octocat",
                                                                                                                "followers_url": "https://api.github.com/users/octocat/followers",
                                                                                                                "following_url": "https://api.github.com/users/octocat/following{/other_user}",
                                                                                                                "gists_url": "https://api.github.com/users/octocat/gists{/gist_id}",
                                                                                                                "starred_url": "https://api.github.com/users/octocat/starred{/owner}{/repo}",
                                                                                                                "subscriptions_url": "https://api.github.com/users/octocat/subscriptions",
                                                                                                                "organizations_url": "https://api.github.com/users/octocat/orgs",
                                                                                                                "repos_url": "https://api.github.com/users/octocat/repos",
                                                                                                                "events_url": "https://api.github.com/users/octocat/events{/privacy}",
                                                                                                                "received_events_url": "https://api.github.com/users/octocat/received_events",
                                                                                                                "type": "User",
                                                                                                                "site_admin": false
                                                                                                              },
                                                                                                              "repo": {
                                                                                                                "id": 1296269,
                                                                                                                "owner": {
                                                                                                                  "login": "octocat",
                                                                                                                  "id": 1,
                                                                                                                  "avatar_url": "https://github.com/images/error/octocat_happy.gif",
                                                                                                                  "gravatar_id": "",
                                                                                                                  "url": "https://api.github.com/users/octocat",
                                                                                                                  "html_url": "https://github.com/octocat",
                                                                                                                  "followers_url": "https://api.github.com/users/octocat/followers",
                                                                                                                  "following_url": "https://api.github.com/users/octocat/following{/other_user}",
                                                                                                                  "gists_url": "https://api.github.com/users/octocat/gists{/gist_id}",
                                                                                                                  "starred_url": "https://api.github.com/users/octocat/starred{/owner}{/repo}",
                                                                                                                  "subscriptions_url": "https://api.github.com/users/octocat/subscriptions",
                                                                                                                  "organizations_url": "https://api.github.com/users/octocat/orgs",
                                                                                                                  "repos_url": "https://api.github.com/users/octocat/repos",
                                                                                                                  "events_url": "https://api.github.com/users/octocat/events{/privacy}",
                                                                                                                  "received_events_url": "https://api.github.com/users/octocat/received_events",
                                                                                                                  "type": "User",
                                                                                                                  "site_admin": false
                                                                                                                },
                                                                                                                "name": "Hello-World",
                                                                                                                "full_name": "octocat/Hello-World",
                                                                                                                "description": "This your first repo!",
                                                                                                                "private": false,
                                                                                                                "fork": false,
                                                                                                                "url": "https://api.github.com/repos/octocat/Hello-World",
                                                                                                                "html_url": "https://github.com/octocat/Hello-World",
                                                                                                                "archive_url": "http://api.github.com/repos/octocat/Hello-World/{archive_format}{/ref}",
                                                                                                                "assignees_url": "http://api.github.com/repos/octocat/Hello-World/assignees{/user}",
                                                                                                                "blobs_url": "http://api.github.com/repos/octocat/Hello-World/git/blobs{/sha}",
                                                                                                                "branches_url": "http://api.github.com/repos/octocat/Hello-World/branches{/branch}",
                                                                                                                "clone_url": "https://github.com/octocat/Hello-World.git",
                                                                                                                "collaborators_url": "http://api.github.com/repos/octocat/Hello-World/collaborators{/collaborator}",
                                                                                                                "comments_url": "http://api.github.com/repos/octocat/Hello-World/comments{/number}",
                                                                                                                "commits_url": "http://api.github.com/repos/octocat/Hello-World/commits{/sha}",
                                                                                                                "compare_url": "http://api.github.com/repos/octocat/Hello-World/compare/{base}...{head}",
                                                                                                                "contents_url": "http://api.github.com/repos/octocat/Hello-World/contents/{+path}",
                                                                                                                "contributors_url": "http://api.github.com/repos/octocat/Hello-World/contributors",
                                                                                                                "deployments_url": "http://api.github.com/repos/octocat/Hello-World/deployments",
                                                                                                                "downloads_url": "http://api.github.com/repos/octocat/Hello-World/downloads",
                                                                                                                "events_url": "http://api.github.com/repos/octocat/Hello-World/events",
                                                                                                                "forks_url": "http://api.github.com/repos/octocat/Hello-World/forks",
                                                                                                                "git_commits_url": "http://api.github.com/repos/octocat/Hello-World/git/commits{/sha}",
                                                                                                                "git_refs_url": "http://api.github.com/repos/octocat/Hello-World/git/refs{/sha}",
                                                                                                                "git_tags_url": "http://api.github.com/repos/octocat/Hello-World/git/tags{/sha}",
                                                                                                                "git_url": "git:github.com/octocat/Hello-World.git",
                                                                                                                "hooks_url": "http://api.github.com/repos/octocat/Hello-World/hooks",
                                                                                                                "issue_comment_url": "http://api.github.com/repos/octocat/Hello-World/issues/comments{/number}",
                                                                                                                "issue_events_url": "http://api.github.com/repos/octocat/Hello-World/issues/events{/number}",
                                                                                                                "issues_url": "http://api.github.com/repos/octocat/Hello-World/issues{/number}",
                                                                                                                "keys_url": "http://api.github.com/repos/octocat/Hello-World/keys{/key_id}",
                                                                                                                "labels_url": "http://api.github.com/repos/octocat/Hello-World/labels{/name}",
                                                                                                                "languages_url": "http://api.github.com/repos/octocat/Hello-World/languages",
                                                                                                                "merges_url": "http://api.github.com/repos/octocat/Hello-World/merges",
                                                                                                                "milestones_url": "http://api.github.com/repos/octocat/Hello-World/milestones{/number}",
                                                                                                                "mirror_url": "git:git.example.com/octocat/Hello-World",
                                                                                                                "notifications_url": "http://api.github.com/repos/octocat/Hello-World/notifications{?since,all,participating}",
                                                                                                                "pulls_url": "http://api.github.com/repos/octocat/Hello-World/pulls{/number}",
                                                                                                                "releases_url": "http://api.github.com/repos/octocat/Hello-World/releases{/id}",
                                                                                                                "ssh_url": "git@github.com:octocat/Hello-World.git",
                                                                                                                "stargazers_url": "http://api.github.com/repos/octocat/Hello-World/stargazers",
                                                                                                                "statuses_url": "http://api.github.com/repos/octocat/Hello-World/statuses/{sha}",
                                                                                                                "subscribers_url": "http://api.github.com/repos/octocat/Hello-World/subscribers",
                                                                                                                "subscription_url": "http://api.github.com/repos/octocat/Hello-World/subscription",
                                                                                                                "svn_url": "https://svn.github.com/octocat/Hello-World",
                                                                                                                "tags_url": "http://api.github.com/repos/octocat/Hello-World/tags",
                                                                                                                "teams_url": "http://api.github.com/repos/octocat/Hello-World/teams",
                                                                                                                "trees_url": "http://api.github.com/repos/octocat/Hello-World/git/trees{/sha}",
                                                                                                                "homepage": "https://github.com",
                                                                                                                "language": null,
                                                                                                                "forks_count": 9,
                                                                                                                "stargazers_count": 80,
                                                                                                                "watchers_count": 80,
                                                                                                                "size": 108,
                                                                                                                "default_branch": "master",
                                                                                                                "open_issues_count": 0,
                                                                                                                "topics": [
                                                                                                                  "octocat",
                                                                                                                  "atom",
                                                                                                                  "electron",
                                                                                                                  "API"
                                                                                                                ],
                                                                                                                "has_issues": true,
                                                                                                                "has_wiki": true,
                                                                                                                "has_pages": false,
                                                                                                                "has_downloads": true,
                                                                                                                "archived": false,
                                                                                                                "pushed_at": "2011-01-26T19:06:43Z",
                                                                                                                "created_at": "2011-01-26T19:01:12Z",
                                                                                                                "updated_at": "2011-01-26T19:14:43Z",
                                                                                                                "permissions": {
                                                                                                                  "admin": false,
                                                                                                                  "push": false,
                                                                                                                  "pull": true
                                                                                                                },
                                                                                                                "allow_rebase_merge": true,
                                                                                                                "allow_squash_merge": true,
                                                                                                                "allow_merge_commit": true,
                                                                                                                "subscribers_count": 42,
                                                                                                                "network_count": 0
                                                                                                              }
                                                                                                            },
                                                                                                            "_links": {
                                                                                                              "self": {
                                                                                                                "href": "https://api.github.com/repos/octocat/Hello-World/pulls/1347"
                                                                                                              },
                                                                                                              "html": {
                                                                                                                "href": "https://github.com/octocat/Hello-World/pull/1347"
                                                                                                              },
                                                                                                              "issue": {
                                                                                                                "href": "https://api.github.com/repos/octocat/Hello-World/issues/1347"
                                                                                                              },
                                                                                                              "comments": {
                                                                                                                "href": "https://api.github.com/repos/octocat/Hello-World/issues/1347/comments"
                                                                                                              },
                                                                                                              "review_comments": {
                                                                                                                "href": "https://api.github.com/repos/octocat/Hello-World/pulls/1347/comments"
                                                                                                              },
                                                                                                              "review_comment": {
                                                                                                                "href": "https://api.github.com/repos/octocat/Hello-World/pulls/comments{/number}"
                                                                                                              },
                                                                                                              "commits": {
                                                                                                                "href": "https://api.github.com/repos/octocat/Hello-World/pulls/1347/commits"
                                                                                                              },
                                                                                                              "statuses": {
                                                                                                                "href": "https://api.github.com/repos/octocat/Hello-World/statuses/6dcb09b5b57875f334f61aebed695e2e4193db5e"
                                                                                                              }
                                                                                                            },
                                                                                                            "user": {
                                                                                                              "login": "octocat",
                                                                                                              "id": 1,
                                                                                                              "avatar_url": "https://github.com/images/error/octocat_happy.gif",
                                                                                                              "gravatar_id": "",
                                                                                                              "url": "https://api.github.com/users/octocat",
                                                                                                              "html_url": "https://github.com/octocat",
                                                                                                              "followers_url": "https://api.github.com/users/octocat/followers",
                                                                                                              "following_url": "https://api.github.com/users/octocat/following{/other_user}",
                                                                                                              "gists_url": "https://api.github.com/users/octocat/gists{/gist_id}",
                                                                                                              "starred_url": "https://api.github.com/users/octocat/starred{/owner}{/repo}",
                                                                                                              "subscriptions_url": "https://api.github.com/users/octocat/subscriptions",
                                                                                                              "organizations_url": "https://api.github.com/users/octocat/orgs",
                                                                                                              "repos_url": "https://api.github.com/users/octocat/repos",
                                                                                                              "events_url": "https://api.github.com/users/octocat/events{/privacy}",
                                                                                                              "received_events_url": "https://api.github.com/users/octocat/received_events",
                                                                                                              "type": "User",
                                                                                                              "site_admin": false
                                                                                                            }
                                                                                                          }
                                                                                                          

                                                                                                          Update a pull request

                                                                                                          PATCH /repos/:owner/:repo/pulls/:number
                                                                                                          

                                                                                                          Input

                                                                                                          Name Type Description
                                                                                                          title string The title of the pull request.
                                                                                                          body string The contents of the pull request.
                                                                                                          state string State of this Pull Request. Either open or closed.
                                                                                                          base string The name of the branch you want your changes pulled into. This should be an existing branch on the current repository. You cannot update the base branch on a pull request to point to another repository.
                                                                                                          maintainer_can_modify boolean Indicates whether maintainers can modify the pull request.

                                                                                                          Example

                                                                                                          {
                                                                                                            "title": "new title",
                                                                                                            "body": "updated body",
                                                                                                            "state": "open",
                                                                                                            "base": "master"
                                                                                                          }
                                                                                                          

                                                                                                          Response

                                                                                                          Status: 200 OK
                                                                                                          
                                                                                                          {
                                                                                                            "id": 1,
                                                                                                            "url": "https://api.github.com/repos/octocat/Hello-World/pulls/1347",
                                                                                                            "html_url": "https://github.com/octocat/Hello-World/pull/1347",
                                                                                                            "diff_url": "https://github.com/octocat/Hello-World/pull/1347.diff",
                                                                                                            "patch_url": "https://github.com/octocat/Hello-World/pull/1347.patch",
                                                                                                            "issue_url": "https://api.github.com/repos/octocat/Hello-World/issues/1347",
                                                                                                            "commits_url": "https://api.github.com/repos/octocat/Hello-World/pulls/1347/commits",
                                                                                                            "review_comments_url": "https://api.github.com/repos/octocat/Hello-World/pulls/1347/comments",
                                                                                                            "review_comment_url": "https://api.github.com/repos/octocat/Hello-World/pulls/comments{/number}",
                                                                                                            "comments_url": "https://api.github.com/repos/octocat/Hello-World/issues/1347/comments",
                                                                                                            "statuses_url": "https://api.github.com/repos/octocat/Hello-World/statuses/6dcb09b5b57875f334f61aebed695e2e4193db5e",
                                                                                                            "number": 1347,
                                                                                                            "state": "open",
                                                                                                            "title": "new-feature",
                                                                                                            "body": "Please pull these awesome changes",
                                                                                                            "assignee": {
                                                                                                              "login": "octocat",
                                                                                                              "id": 1,
                                                                                                              "avatar_url": "https://github.com/images/error/octocat_happy.gif",
                                                                                                              "gravatar_id": "",
                                                                                                              "url": "https://api.github.com/users/octocat",
                                                                                                              "html_url": "https://github.com/octocat",
                                                                                                              "followers_url": "https://api.github.com/users/octocat/followers",
                                                                                                              "following_url": "https://api.github.com/users/octocat/following{/other_user}",
                                                                                                              "gists_url": "https://api.github.com/users/octocat/gists{/gist_id}",
                                                                                                              "starred_url": "https://api.github.com/users/octocat/starred{/owner}{/repo}",
                                                                                                              "subscriptions_url": "https://api.github.com/users/octocat/subscriptions",
                                                                                                              "organizations_url": "https://api.github.com/users/octocat/orgs",
                                                                                                              "repos_url": "https://api.github.com/users/octocat/repos",
                                                                                                              "events_url": "https://api.github.com/users/octocat/events{/privacy}",
                                                                                                              "received_events_url": "https://api.github.com/users/octocat/received_events",
                                                                                                              "type": "User",
                                                                                                              "site_admin": false
                                                                                                            },
                                                                                                            "milestone": {
                                                                                                              "url": "https://api.github.com/repos/octocat/Hello-World/milestones/1",
                                                                                                              "html_url": "https://github.com/octocat/Hello-World/milestones/v1.0",
                                                                                                              "labels_url": "https://api.github.com/repos/octocat/Hello-World/milestones/1/labels",
                                                                                                              "id": 1002604,
                                                                                                              "number": 1,
                                                                                                              "state": "open",
                                                                                                              "title": "v1.0",
                                                                                                              "description": "Tracking milestone for version 1.0",
                                                                                                              "creator": {
                                                                                                                "login": "octocat",
                                                                                                                "id": 1,
                                                                                                                "avatar_url": "https://github.com/images/error/octocat_happy.gif",
                                                                                                                "gravatar_id": "",
                                                                                                                "url": "https://api.github.com/users/octocat",
                                                                                                                "html_url": "https://github.com/octocat",
                                                                                                                "followers_url": "https://api.github.com/users/octocat/followers",
                                                                                                                "following_url": "https://api.github.com/users/octocat/following{/other_user}",
                                                                                                                "gists_url": "https://api.github.com/users/octocat/gists{/gist_id}",
                                                                                                                "starred_url": "https://api.github.com/users/octocat/starred{/owner}{/repo}",
                                                                                                                "subscriptions_url": "https://api.github.com/users/octocat/subscriptions",
                                                                                                                "organizations_url": "https://api.github.com/users/octocat/orgs",
                                                                                                                "repos_url": "https://api.github.com/users/octocat/repos",
                                                                                                                "events_url": "https://api.github.com/users/octocat/events{/privacy}",
                                                                                                                "received_events_url": "https://api.github.com/users/octocat/received_events",
                                                                                                                "type": "User",
                                                                                                                "site_admin": false
                                                                                                              },
                                                                                                              "open_issues": 4,
                                                                                                              "closed_issues": 8,
                                                                                                              "created_at": "2011-04-10T20:09:31Z",
                                                                                                              "updated_at": "2014-03-03T18:58:10Z",
                                                                                                              "closed_at": "2013-02-12T13:22:01Z",
                                                                                                              "due_on": "2012-10-09T23:39:01Z"
                                                                                                            },
                                                                                                            "locked": true,
                                                                                                            "active_lock_reason": "too heated",
                                                                                                            "created_at": "2011-01-26T19:01:12Z",
                                                                                                            "updated_at": "2011-01-26T19:01:12Z",
                                                                                                            "closed_at": "2011-01-26T19:01:12Z",
                                                                                                            "merged_at": "2011-01-26T19:01:12Z",
                                                                                                            "head": {
                                                                                                              "label": "new-topic",
                                                                                                              "ref": "new-topic",
                                                                                                              "sha": "6dcb09b5b57875f334f61aebed695e2e4193db5e",
                                                                                                              "user": {
                                                                                                                "login": "octocat",
                                                                                                                "id": 1,
                                                                                                                "avatar_url": "https://github.com/images/error/octocat_happy.gif",
                                                                                                                "gravatar_id": "",
                                                                                                                "url": "https://api.github.com/users/octocat",
                                                                                                                "html_url": "https://github.com/octocat",
                                                                                                                "followers_url": "https://api.github.com/users/octocat/followers",
                                                                                                                "following_url": "https://api.github.com/users/octocat/following{/other_user}",
                                                                                                                "gists_url": "https://api.github.com/users/octocat/gists{/gist_id}",
                                                                                                                "starred_url": "https://api.github.com/users/octocat/starred{/owner}{/repo}",
                                                                                                                "subscriptions_url": "https://api.github.com/users/octocat/subscriptions",
                                                                                                                "organizations_url": "https://api.github.com/users/octocat/orgs",
                                                                                                                "repos_url": "https://api.github.com/users/octocat/repos",
                                                                                                                "events_url": "https://api.github.com/users/octocat/events{/privacy}",
                                                                                                                "received_events_url": "https://api.github.com/users/octocat/received_events",
                                                                                                                "type": "User",
                                                                                                                "site_admin": false
                                                                                                              },
                                                                                                              "repo": {
                                                                                                                "id": 1296269,
                                                                                                                "owner": {
                                                                                                                  "login": "octocat",
                                                                                                                  "id": 1,
                                                                                                                  "avatar_url": "https://github.com/images/error/octocat_happy.gif",
                                                                                                                  "gravatar_id": "",
                                                                                                                  "url": "https://api.github.com/users/octocat",
                                                                                                                  "html_url": "https://github.com/octocat",
                                                                                                                  "followers_url": "https://api.github.com/users/octocat/followers",
                                                                                                                  "following_url": "https://api.github.com/users/octocat/following{/other_user}",
                                                                                                                  "gists_url": "https://api.github.com/users/octocat/gists{/gist_id}",
                                                                                                                  "starred_url": "https://api.github.com/users/octocat/starred{/owner}{/repo}",
                                                                                                                  "subscriptions_url": "https://api.github.com/users/octocat/subscriptions",
                                                                                                                  "organizations_url": "https://api.github.com/users/octocat/orgs",
                                                                                                                  "repos_url": "https://api.github.com/users/octocat/repos",
                                                                                                                  "events_url": "https://api.github.com/users/octocat/events{/privacy}",
                                                                                                                  "received_events_url": "https://api.github.com/users/octocat/received_events",
                                                                                                                  "type": "User",
                                                                                                                  "site_admin": false
                                                                                                                },
                                                                                                                "name": "Hello-World",
                                                                                                                "full_name": "octocat/Hello-World",
                                                                                                                "description": "This your first repo!",
                                                                                                                "private": false,
                                                                                                                "fork": false,
                                                                                                                "url": "https://api.github.com/repos/octocat/Hello-World",
                                                                                                                "html_url": "https://github.com/octocat/Hello-World",
                                                                                                                "archive_url": "http://api.github.com/repos/octocat/Hello-World/{archive_format}{/ref}",
                                                                                                                "assignees_url": "http://api.github.com/repos/octocat/Hello-World/assignees{/user}",
                                                                                                                "blobs_url": "http://api.github.com/repos/octocat/Hello-World/git/blobs{/sha}",
                                                                                                                "branches_url": "http://api.github.com/repos/octocat/Hello-World/branches{/branch}",
                                                                                                                "clone_url": "https://github.com/octocat/Hello-World.git",
                                                                                                                "collaborators_url": "http://api.github.com/repos/octocat/Hello-World/collaborators{/collaborator}",
                                                                                                                "comments_url": "http://api.github.com/repos/octocat/Hello-World/comments{/number}",
                                                                                                                "commits_url": "http://api.github.com/repos/octocat/Hello-World/commits{/sha}",
                                                                                                                "compare_url": "http://api.github.com/repos/octocat/Hello-World/compare/{base}...{head}",
                                                                                                                "contents_url": "http://api.github.com/repos/octocat/Hello-World/contents/{+path}",
                                                                                                                "contributors_url": "http://api.github.com/repos/octocat/Hello-World/contributors",
                                                                                                                "deployments_url": "http://api.github.com/repos/octocat/Hello-World/deployments",
                                                                                                                "downloads_url": "http://api.github.com/repos/octocat/Hello-World/downloads",
                                                                                                                "events_url": "http://api.github.com/repos/octocat/Hello-World/events",
                                                                                                                "forks_url": "http://api.github.com/repos/octocat/Hello-World/forks",
                                                                                                                "git_commits_url": "http://api.github.com/repos/octocat/Hello-World/git/commits{/sha}",
                                                                                                                "git_refs_url": "http://api.github.com/repos/octocat/Hello-World/git/refs{/sha}",
                                                                                                                "git_tags_url": "http://api.github.com/repos/octocat/Hello-World/git/tags{/sha}",
                                                                                                                "git_url": "git:github.com/octocat/Hello-World.git",
                                                                                                                "hooks_url": "http://api.github.com/repos/octocat/Hello-World/hooks",
                                                                                                                "issue_comment_url": "http://api.github.com/repos/octocat/Hello-World/issues/comments{/number}",
                                                                                                                "issue_events_url": "http://api.github.com/repos/octocat/Hello-World/issues/events{/number}",
                                                                                                                "issues_url": "http://api.github.com/repos/octocat/Hello-World/issues{/number}",
                                                                                                                "keys_url": "http://api.github.com/repos/octocat/Hello-World/keys{/key_id}",
                                                                                                                "labels_url": "http://api.github.com/repos/octocat/Hello-World/labels{/name}",
                                                                                                                "languages_url": "http://api.github.com/repos/octocat/Hello-World/languages",
                                                                                                                "merges_url": "http://api.github.com/repos/octocat/Hello-World/merges",
                                                                                                                "milestones_url": "http://api.github.com/repos/octocat/Hello-World/milestones{/number}",
                                                                                                                "mirror_url": "git:git.example.com/octocat/Hello-World",
                                                                                                                "notifications_url": "http://api.github.com/repos/octocat/Hello-World/notifications{?since,all,participating}",
                                                                                                                "pulls_url": "http://api.github.com/repos/octocat/Hello-World/pulls{/number}",
                                                                                                                "releases_url": "http://api.github.com/repos/octocat/Hello-World/releases{/id}",
                                                                                                                "ssh_url": "git@github.com:octocat/Hello-World.git",
                                                                                                                "stargazers_url": "http://api.github.com/repos/octocat/Hello-World/stargazers",
                                                                                                                "statuses_url": "http://api.github.com/repos/octocat/Hello-World/statuses/{sha}",
                                                                                                                "subscribers_url": "http://api.github.com/repos/octocat/Hello-World/subscribers",
                                                                                                                "subscription_url": "http://api.github.com/repos/octocat/Hello-World/subscription",
                                                                                                                "svn_url": "https://svn.github.com/octocat/Hello-World",
                                                                                                                "tags_url": "http://api.github.com/repos/octocat/Hello-World/tags",
                                                                                                                "teams_url": "http://api.github.com/repos/octocat/Hello-World/teams",
                                                                                                                "trees_url": "http://api.github.com/repos/octocat/Hello-World/git/trees{/sha}",
                                                                                                                "homepage": "https://github.com",
                                                                                                                "language": null,
                                                                                                                "forks_count": 9,
                                                                                                                "stargazers_count": 80,
                                                                                                                "watchers_count": 80,
                                                                                                                "size": 108,
                                                                                                                "default_branch": "master",
                                                                                                                "open_issues_count": 0,
                                                                                                                "topics": [
                                                                                                                  "octocat",
                                                                                                                  "atom",
                                                                                                                  "electron",
                                                                                                                  "API"
                                                                                                                ],
                                                                                                                "has_issues": true,
                                                                                                                "has_wiki": true,
                                                                                                                "has_pages": false,
                                                                                                                "has_downloads": true,
                                                                                                                "archived": false,
                                                                                                                "pushed_at": "2011-01-26T19:06:43Z",
                                                                                                                "created_at": "2011-01-26T19:01:12Z",
                                                                                                                "updated_at": "2011-01-26T19:14:43Z",
                                                                                                                "permissions": {
                                                                                                                  "admin": false,
                                                                                                                  "push": false,
                                                                                                                  "pull": true
                                                                                                                },
                                                                                                                "allow_rebase_merge": true,
                                                                                                                "allow_squash_merge": true,
                                                                                                                "allow_merge_commit": true,
                                                                                                                "subscribers_count": 42,
                                                                                                                "network_count": 0
                                                                                                              }
                                                                                                            },
                                                                                                            "base": {
                                                                                                              "label": "master",
                                                                                                              "ref": "master",
                                                                                                              "sha": "6dcb09b5b57875f334f61aebed695e2e4193db5e",
                                                                                                              "user": {
                                                                                                                "login": "octocat",
                                                                                                                "id": 1,
                                                                                                                "avatar_url": "https://github.com/images/error/octocat_happy.gif",
                                                                                                                "gravatar_id": "",
                                                                                                                "url": "https://api.github.com/users/octocat",
                                                                                                                "html_url": "https://github.com/octocat",
                                                                                                                "followers_url": "https://api.github.com/users/octocat/followers",
                                                                                                                "following_url": "https://api.github.com/users/octocat/following{/other_user}",
                                                                                                                "gists_url": "https://api.github.com/users/octocat/gists{/gist_id}",
                                                                                                                "starred_url": "https://api.github.com/users/octocat/starred{/owner}{/repo}",
                                                                                                                "subscriptions_url": "https://api.github.com/users/octocat/subscriptions",
                                                                                                                "organizations_url": "https://api.github.com/users/octocat/orgs",
                                                                                                                "repos_url": "https://api.github.com/users/octocat/repos",
                                                                                                                "events_url": "https://api.github.com/users/octocat/events{/privacy}",
                                                                                                                "received_events_url": "https://api.github.com/users/octocat/received_events",
                                                                                                                "type": "User",
                                                                                                                "site_admin": false
                                                                                                              },
                                                                                                              "repo": {
                                                                                                                "id": 1296269,
                                                                                                                "owner": {
                                                                                                                  "login": "octocat",
                                                                                                                  "id": 1,
                                                                                                                  "avatar_url": "https://github.com/images/error/octocat_happy.gif",
                                                                                                                  "gravatar_id": "",
                                                                                                                  "url": "https://api.github.com/users/octocat",
                                                                                                                  "html_url": "https://github.com/octocat",
                                                                                                                  "followers_url": "https://api.github.com/users/octocat/followers",
                                                                                                                  "following_url": "https://api.github.com/users/octocat/following{/other_user}",
                                                                                                                  "gists_url": "https://api.github.com/users/octocat/gists{/gist_id}",
                                                                                                                  "starred_url": "https://api.github.com/users/octocat/starred{/owner}{/repo}",
                                                                                                                  "subscriptions_url": "https://api.github.com/users/octocat/subscriptions",
                                                                                                                  "organizations_url": "https://api.github.com/users/octocat/orgs",
                                                                                                                  "repos_url": "https://api.github.com/users/octocat/repos",
                                                                                                                  "events_url": "https://api.github.com/users/octocat/events{/privacy}",
                                                                                                                  "received_events_url": "https://api.github.com/users/octocat/received_events",
                                                                                                                  "type": "User",
                                                                                                                  "site_admin": false
                                                                                                                },
                                                                                                                "name": "Hello-World",
                                                                                                                "full_name": "octocat/Hello-World",
                                                                                                                "description": "This your first repo!",
                                                                                                                "private": false,
                                                                                                                "fork": false,
                                                                                                                "url": "https://api.github.com/repos/octocat/Hello-World",
                                                                                                                "html_url": "https://github.com/octocat/Hello-World",
                                                                                                                "archive_url": "http://api.github.com/repos/octocat/Hello-World/{archive_format}{/ref}",
                                                                                                                "assignees_url": "http://api.github.com/repos/octocat/Hello-World/assignees{/user}",
                                                                                                                "blobs_url": "http://api.github.com/repos/octocat/Hello-World/git/blobs{/sha}",
                                                                                                                "branches_url": "http://api.github.com/repos/octocat/Hello-World/branches{/branch}",
                                                                                                                "clone_url": "https://github.com/octocat/Hello-World.git",
                                                                                                                "collaborators_url": "http://api.github.com/repos/octocat/Hello-World/collaborators{/collaborator}",
                                                                                                                "comments_url": "http://api.github.com/repos/octocat/Hello-World/comments{/number}",
                                                                                                                "commits_url": "http://api.github.com/repos/octocat/Hello-World/commits{/sha}",
                                                                                                                "compare_url": "http://api.github.com/repos/octocat/Hello-World/compare/{base}...{head}",
                                                                                                                "contents_url": "http://api.github.com/repos/octocat/Hello-World/contents/{+path}",
                                                                                                                "contributors_url": "http://api.github.com/repos/octocat/Hello-World/contributors",
                                                                                                                "deployments_url": "http://api.github.com/repos/octocat/Hello-World/deployments",
                                                                                                                "downloads_url": "http://api.github.com/repos/octocat/Hello-World/downloads",
                                                                                                                "events_url": "http://api.github.com/repos/octocat/Hello-World/events",
                                                                                                                "forks_url": "http://api.github.com/repos/octocat/Hello-World/forks",
                                                                                                                "git_commits_url": "http://api.github.com/repos/octocat/Hello-World/git/commits{/sha}",
                                                                                                                "git_refs_url": "http://api.github.com/repos/octocat/Hello-World/git/refs{/sha}",
                                                                                                                "git_tags_url": "http://api.github.com/repos/octocat/Hello-World/git/tags{/sha}",
                                                                                                                "git_url": "git:github.com/octocat/Hello-World.git",
                                                                                                                "hooks_url": "http://api.github.com/repos/octocat/Hello-World/hooks",
                                                                                                                "issue_comment_url": "http://api.github.com/repos/octocat/Hello-World/issues/comments{/number}",
                                                                                                                "issue_events_url": "http://api.github.com/repos/octocat/Hello-World/issues/events{/number}",
                                                                                                                "issues_url": "http://api.github.com/repos/octocat/Hello-World/issues{/number}",
                                                                                                                "keys_url": "http://api.github.com/repos/octocat/Hello-World/keys{/key_id}",
                                                                                                                "labels_url": "http://api.github.com/repos/octocat/Hello-World/labels{/name}",
                                                                                                                "languages_url": "http://api.github.com/repos/octocat/Hello-World/languages",
                                                                                                                "merges_url": "http://api.github.com/repos/octocat/Hello-World/merges",
                                                                                                                "milestones_url": "http://api.github.com/repos/octocat/Hello-World/milestones{/number}",
                                                                                                                "mirror_url": "git:git.example.com/octocat/Hello-World",
                                                                                                                "notifications_url": "http://api.github.com/repos/octocat/Hello-World/notifications{?since,all,participating}",
                                                                                                                "pulls_url": "http://api.github.com/repos/octocat/Hello-World/pulls{/number}",
                                                                                                                "releases_url": "http://api.github.com/repos/octocat/Hello-World/releases{/id}",
                                                                                                                "ssh_url": "git@github.com:octocat/Hello-World.git",
                                                                                                                "stargazers_url": "http://api.github.com/repos/octocat/Hello-World/stargazers",
                                                                                                                "statuses_url": "http://api.github.com/repos/octocat/Hello-World/statuses/{sha}",
                                                                                                                "subscribers_url": "http://api.github.com/repos/octocat/Hello-World/subscribers",
                                                                                                                "subscription_url": "http://api.github.com/repos/octocat/Hello-World/subscription",
                                                                                                                "svn_url": "https://svn.github.com/octocat/Hello-World",
                                                                                                                "tags_url": "http://api.github.com/repos/octocat/Hello-World/tags",
                                                                                                                "teams_url": "http://api.github.com/repos/octocat/Hello-World/teams",
                                                                                                                "trees_url": "http://api.github.com/repos/octocat/Hello-World/git/trees{/sha}",
                                                                                                                "homepage": "https://github.com",
                                                                                                                "language": null,
                                                                                                                "forks_count": 9,
                                                                                                                "stargazers_count": 80,
                                                                                                                "watchers_count": 80,
                                                                                                                "size": 108,
                                                                                                                "default_branch": "master",
                                                                                                                "open_issues_count": 0,
                                                                                                                "topics": [
                                                                                                                  "octocat",
                                                                                                                  "atom",
                                                                                                                  "electron",
                                                                                                                  "API"
                                                                                                                ],
                                                                                                                "has_issues": true,
                                                                                                                "has_wiki": true,
                                                                                                                "has_pages": false,
                                                                                                                "has_downloads": true,
                                                                                                                "archived": false,
                                                                                                                "pushed_at": "2011-01-26T19:06:43Z",
                                                                                                                "created_at": "2011-01-26T19:01:12Z",
                                                                                                                "updated_at": "2011-01-26T19:14:43Z",
                                                                                                                "permissions": {
                                                                                                                  "admin": false,
                                                                                                                  "push": false,
                                                                                                                  "pull": true
                                                                                                                },
                                                                                                                "allow_rebase_merge": true,
                                                                                                                "allow_squash_merge": true,
                                                                                                                "allow_merge_commit": true,
                                                                                                                "subscribers_count": 42,
                                                                                                                "network_count": 0
                                                                                                              }
                                                                                                            },
                                                                                                            "_links": {
                                                                                                              "self": {
                                                                                                                "href": "https://api.github.com/repos/octocat/Hello-World/pulls/1347"
                                                                                                              },
                                                                                                              "html": {
                                                                                                                "href": "https://github.com/octocat/Hello-World/pull/1347"
                                                                                                              },
                                                                                                              "issue": {
                                                                                                                "href": "https://api.github.com/repos/octocat/Hello-World/issues/1347"
                                                                                                              },
                                                                                                              "comments": {
                                                                                                                "href": "https://api.github.com/repos/octocat/Hello-World/issues/1347/comments"
                                                                                                              },
                                                                                                              "review_comments": {
                                                                                                                "href": "https://api.github.com/repos/octocat/Hello-World/pulls/1347/comments"
                                                                                                              },
                                                                                                              "review_comment": {
                                                                                                                "href": "https://api.github.com/repos/octocat/Hello-World/pulls/comments{/number}"
                                                                                                              },
                                                                                                              "commits": {
                                                                                                                "href": "https://api.github.com/repos/octocat/Hello-World/pulls/1347/commits"
                                                                                                              },
                                                                                                              "statuses": {
                                                                                                                "href": "https://api.github.com/repos/octocat/Hello-World/statuses/6dcb09b5b57875f334f61aebed695e2e4193db5e"
                                                                                                              }
                                                                                                            },
                                                                                                            "user": {
                                                                                                              "login": "octocat",
                                                                                                              "id": 1,
                                                                                                              "avatar_url": "https://github.com/images/error/octocat_happy.gif",
                                                                                                              "gravatar_id": "",
                                                                                                              "url": "https://api.github.com/users/octocat",
                                                                                                              "html_url": "https://github.com/octocat",
                                                                                                              "followers_url": "https://api.github.com/users/octocat/followers",
                                                                                                              "following_url": "https://api.github.com/users/octocat/following{/other_user}",
                                                                                                              "gists_url": "https://api.github.com/users/octocat/gists{/gist_id}",
                                                                                                              "starred_url": "https://api.github.com/users/octocat/starred{/owner}{/repo}",
                                                                                                              "subscriptions_url": "https://api.github.com/users/octocat/subscriptions",
                                                                                                              "organizations_url": "https://api.github.com/users/octocat/orgs",
                                                                                                              "repos_url": "https://api.github.com/users/octocat/repos",
                                                                                                              "events_url": "https://api.github.com/users/octocat/events{/privacy}",
                                                                                                              "received_events_url": "https://api.github.com/users/octocat/received_events",
                                                                                                              "type": "User",
                                                                                                              "site_admin": false
                                                                                                            }
                                                                                                          }
                                                                                                          

                                                                                                          List commits on a pull request

                                                                                                          Note: The response includes a maximum of 250 commits. To receive a complete commit list for pull requests with more than 250 commits, use the Commit List API.

                                                                                                          GET /repos/:owner/:repo/pulls/:number/commits
                                                                                                          

                                                                                                          Response

                                                                                                          Status: 200 OK
                                                                                                          Link: <https://api.github.com/resource?page=2>; rel="next",
                                                                                                                <https://api.github.com/resource?page=5>; rel="last"
                                                                                                          
                                                                                                          [
                                                                                                            {
                                                                                                              "url": "https://api.github.com/repos/octocat/Hello-World/commits/6dcb09b5b57875f334f61aebed695e2e4193db5e",
                                                                                                              "sha": "6dcb09b5b57875f334f61aebed695e2e4193db5e",
                                                                                                              "html_url": "https://github.com/octocat/Hello-World/commit/6dcb09b5b57875f334f61aebed695e2e4193db5e",
                                                                                                              "comments_url": "https://api.github.com/repos/octocat/Hello-World/commits/6dcb09b5b57875f334f61aebed695e2e4193db5e/comments",
                                                                                                              "commit": {
                                                                                                                "url": "https://api.github.com/repos/octocat/Hello-World/git/commits/6dcb09b5b57875f334f61aebed695e2e4193db5e",
                                                                                                                "author": {
                                                                                                                  "name": "Monalisa Octocat",
                                                                                                                  "email": "support@github.com",
                                                                                                                  "date": "2011-04-14T16:00:49Z"
                                                                                                                },
                                                                                                                "committer": {
                                                                                                                  "name": "Monalisa Octocat",
                                                                                                                  "email": "support@github.com",
                                                                                                                  "date": "2011-04-14T16:00:49Z"
                                                                                                                },
                                                                                                                "message": "Fix all the bugs",
                                                                                                                "tree": {
                                                                                                                  "url": "https://api.github.com/repos/octocat/Hello-World/tree/6dcb09b5b57875f334f61aebed695e2e4193db5e",
                                                                                                                  "sha": "6dcb09b5b57875f334f61aebed695e2e4193db5e"
                                                                                                                },
                                                                                                                "comment_count": 0,
                                                                                                                "verification": {
                                                                                                                  "verified": false,
                                                                                                                  "reason": "unsigned",
                                                                                                                  "signature": null,
                                                                                                                  "payload": null
                                                                                                                }
                                                                                                              },
                                                                                                              "author": {
                                                                                                                "login": "octocat",
                                                                                                                "id": 1,
                                                                                                                "avatar_url": "https://github.com/images/error/octocat_happy.gif",
                                                                                                                "gravatar_id": "",
                                                                                                                "url": "https://api.github.com/users/octocat",
                                                                                                                "html_url": "https://github.com/octocat",
                                                                                                                "followers_url": "https://api.github.com/users/octocat/followers",
                                                                                                                "following_url": "https://api.github.com/users/octocat/following{/other_user}",
                                                                                                                "gists_url": "https://api.github.com/users/octocat/gists{/gist_id}",
                                                                                                                "starred_url": "https://api.github.com/users/octocat/starred{/owner}{/repo}",
                                                                                                                "subscriptions_url": "https://api.github.com/users/octocat/subscriptions",
                                                                                                                "organizations_url": "https://api.github.com/users/octocat/orgs",
                                                                                                                "repos_url": "https://api.github.com/users/octocat/repos",
                                                                                                                "events_url": "https://api.github.com/users/octocat/events{/privacy}",
                                                                                                                "received_events_url": "https://api.github.com/users/octocat/received_events",
                                                                                                                "type": "User",
                                                                                                                "site_admin": false
                                                                                                              },
                                                                                                              "committer": {
                                                                                                                "login": "octocat",
                                                                                                                "id": 1,
                                                                                                                "avatar_url": "https://github.com/images/error/octocat_happy.gif",
                                                                                                                "gravatar_id": "",
                                                                                                                "url": "https://api.github.com/users/octocat",
                                                                                                                "html_url": "https://github.com/octocat",
                                                                                                                "followers_url": "https://api.github.com/users/octocat/followers",
                                                                                                                "following_url": "https://api.github.com/users/octocat/following{/other_user}",
                                                                                                                "gists_url": "https://api.github.com/users/octocat/gists{/gist_id}",
                                                                                                                "starred_url": "https://api.github.com/users/octocat/starred{/owner}{/repo}",
                                                                                                                "subscriptions_url": "https://api.github.com/users/octocat/subscriptions",
                                                                                                                "organizations_url": "https://api.github.com/users/octocat/orgs",
                                                                                                                "repos_url": "https://api.github.com/users/octocat/repos",
                                                                                                                "events_url": "https://api.github.com/users/octocat/events{/privacy}",
                                                                                                                "received_events_url": "https://api.github.com/users/octocat/received_events",
                                                                                                                "type": "User",
                                                                                                                "site_admin": false
                                                                                                              },
                                                                                                              "parents": [
                                                                                                                {
                                                                                                                  "url": "https://api.github.com/repos/octocat/Hello-World/commits/6dcb09b5b57875f334f61aebed695e2e4193db5e",
                                                                                                                  "sha": "6dcb09b5b57875f334f61aebed695e2e4193db5e"
                                                                                                                }
                                                                                                              ]
                                                                                                            }
                                                                                                          ]
                                                                                                          

                                                                                                          List pull requests files

                                                                                                          GET /repos/:owner/:repo/pulls/:number/files
                                                                                                          

                                                                                                          Note: The response includes a maximum of 300 files.

                                                                                                          Response

                                                                                                          Status: 200 OK
                                                                                                          Link: <https://api.github.com/resource?page=2>; rel="next",
                                                                                                                <https://api.github.com/resource?page=5>; rel="last"
                                                                                                          
                                                                                                          [
                                                                                                            {
                                                                                                              "sha": "bbcd538c8e72b8c175046e27cc8f907076331401",
                                                                                                              "filename": "file1.txt",
                                                                                                              "status": "added",
                                                                                                              "additions": 103,
                                                                                                              "deletions": 21,
                                                                                                              "changes": 124,
                                                                                                              "blob_url": "https://github.com/octocat/Hello-World/blob/6dcb09b5b57875f334f61aebed695e2e4193db5e/file1.txt",
                                                                                                              "raw_url": "https://github.com/octocat/Hello-World/raw/6dcb09b5b57875f334f61aebed695e2e4193db5e/file1.txt",
                                                                                                              "contents_url": "https://api.github.com/repos/octocat/Hello-World/contents/file1.txt?ref=6dcb09b5b57875f334f61aebed695e2e4193db5e",
                                                                                                              "patch": "@@ -132,7 +132,7 @@ module Test @@ -1000,7 +1000,7 @@ module Test"
                                                                                                            }
                                                                                                          ]
                                                                                                          

                                                                                                          Get if a pull request has been merged

                                                                                                          GET /repos/:owner/:repo/pulls/:number/merge
                                                                                                          

                                                                                                          Response if pull request has been merged

                                                                                                          Status: 204 No Content
                                                                                                          

                                                                                                          Response if pull request has not been merged

                                                                                                          Status: 404 Not Found
                                                                                                          

                                                                                                          Merge a pull request (Merge Button)

                                                                                                          PUT /repos/:owner/:repo/pulls/:number/merge
                                                                                                          

                                                                                                          Input

                                                                                                          Name Type Description
                                                                                                          commit_title string Title for the automatic commit message.
                                                                                                          commit_message string Extra detail to append to automatic commit message.
                                                                                                          sha string SHA that pull request head must match to allow merge.
                                                                                                          merge_method string Merge method to use. Possible values are merge, squash or rebase. Default is merge.

                                                                                                          Response if merge was successful

                                                                                                          Status: 200 OK
                                                                                                          
                                                                                                          {
                                                                                                            "sha": "6dcb09b5b57875f334f61aebed695e2e4193db5e",
                                                                                                            "merged": true,
                                                                                                            "message": "Pull Request successfully merged"
                                                                                                          }
                                                                                                          

                                                                                                          Response if merge cannot be performed

                                                                                                          Status: 405 Method not allowed
                                                                                                          
                                                                                                          {
                                                                                                            "message": "Pull Request is not mergeable",
                                                                                                            "documentation_url": "https://developer.github.com/v3/pulls/#merge-a-pull-request-merge-button"
                                                                                                          }
                                                                                                          

                                                                                                          Response if sha was provided and pull request head did not match

                                                                                                          Status: 409 Conflict
                                                                                                          
                                                                                                          {
                                                                                                            "message": "Head branch was modified. Review and try the merge again.",
                                                                                                            "documentation_url": "https://developer.github.com/v3/pulls/#merge-a-pull-request-merge-button"
                                                                                                          }
                                                                                                          

                                                                                                          Labels, assignees, and milestones

                                                                                                          Every pull request is an issue, but not every issue is a pull request. For this reason, "shared" actions for both features, like manipulating assignees, labels and milestones, are provided within the Issues API.

                                                                                                          Custom media types

                                                                                                          These are the supported media types for pull requests. You can read more about the use of media types in the API here.

                                                                                                          application/vnd.github.VERSION.raw+json
                                                                                                          application/vnd.github.VERSION.text+json
                                                                                                          application/vnd.github.VERSION.html+json
                                                                                                          application/vnd.github.VERSION.full+json
                                                                                                          application/vnd.github.VERSION.diff
                                                                                                          application/vnd.github.VERSION.patch
                                                                                                          

                                                                                                          If a diff is corrupt, contact GitHub support. Include the repository name and pull request ID in your message.

                                                                                                          tmp/developer.github.com/v3/pulls/comments/index.html Review Comments | GitHub Developer Guide

                                                                                                          Review Comments

                                                                                                          Pull Request review comments are comments on a portion of the unified diff. These are separate from Commit Comments (which are applied directly to a commit, outside of the Pull Request view), and Issue Comments (which do not reference a portion of the unified diff).

                                                                                                          Pull Request review comments use these custom media types. You can read more about the use of media types in the API here.

                                                                                                          List comments on a pull request

                                                                                                          GET /repos/:owner/:repo/pulls/:number/comments
                                                                                                          

                                                                                                          By default, review comments are ordered by ascending ID.

                                                                                                          Parameters

                                                                                                          Name Type Description
                                                                                                          sort string Can be either created or updated comments. Default: created
                                                                                                          direction string Can be either asc or desc. Ignored without sort parameter.
                                                                                                          since string This is a timestamp in ISO 8601 format: YYYY-MM-DDTHH:MM:SSZ. Only returns comments updated at or after this time.

                                                                                                          Response

                                                                                                          Status: 200 OK
                                                                                                          Link: <https://api.github.com/resource?page=2>; rel="next",
                                                                                                                <https://api.github.com/resource?page=5>; rel="last"
                                                                                                          
                                                                                                          [
                                                                                                            {
                                                                                                              "url": "https://api.github.com/repos/octocat/Hello-World/pulls/comments/1",
                                                                                                              "id": 10,
                                                                                                              "pull_request_review_id": 42,
                                                                                                              "diff_hunk": "@@ -16,33 +16,40 @@ public class Connection : IConnection...",
                                                                                                              "path": "file1.txt",
                                                                                                              "position": 1,
                                                                                                              "original_position": 4,
                                                                                                              "commit_id": "6dcb09b5b57875f334f61aebed695e2e4193db5e",
                                                                                                              "original_commit_id": "9c48853fa3dc5c1c3d6f1f1cd1f2743e72652840",
                                                                                                              "in_reply_to_id": 8,
                                                                                                              "user": {
                                                                                                                "login": "octocat",
                                                                                                                "id": 1,
                                                                                                                "avatar_url": "https://github.com/images/error/octocat_happy.gif",
                                                                                                                "gravatar_id": "",
                                                                                                                "url": "https://api.github.com/users/octocat",
                                                                                                                "html_url": "https://github.com/octocat",
                                                                                                                "followers_url": "https://api.github.com/users/octocat/followers",
                                                                                                                "following_url": "https://api.github.com/users/octocat/following{/other_user}",
                                                                                                                "gists_url": "https://api.github.com/users/octocat/gists{/gist_id}",
                                                                                                                "starred_url": "https://api.github.com/users/octocat/starred{/owner}{/repo}",
                                                                                                                "subscriptions_url": "https://api.github.com/users/octocat/subscriptions",
                                                                                                                "organizations_url": "https://api.github.com/users/octocat/orgs",
                                                                                                                "repos_url": "https://api.github.com/users/octocat/repos",
                                                                                                                "events_url": "https://api.github.com/users/octocat/events{/privacy}",
                                                                                                                "received_events_url": "https://api.github.com/users/octocat/received_events",
                                                                                                                "type": "User",
                                                                                                                "site_admin": false
                                                                                                              },
                                                                                                              "body": "Great stuff",
                                                                                                              "created_at": "2011-04-14T16:00:49Z",
                                                                                                              "updated_at": "2011-04-14T16:00:49Z",
                                                                                                              "html_url": "https://github.com/octocat/Hello-World/pull/1#discussion-diff-1",
                                                                                                              "pull_request_url": "https://api.github.com/repos/octocat/Hello-World/pulls/1",
                                                                                                              "_links": {
                                                                                                                "self": {
                                                                                                                  "href": "https://api.github.com/repos/octocat/Hello-World/pulls/comments/1"
                                                                                                                },
                                                                                                                "html": {
                                                                                                                  "href": "https://github.com/octocat/Hello-World/pull/1#discussion-diff-1"
                                                                                                                },
                                                                                                                "pull_request": {
                                                                                                                  "href": "https://api.github.com/repos/octocat/Hello-World/pulls/1"
                                                                                                                }
                                                                                                              }
                                                                                                            }
                                                                                                          ]
                                                                                                          

                                                                                                          Reactions summary

                                                                                                          An additional reactions object in the review comment payload is currently available for developers to preview. During the preview period, the APIs may change without advance notice. Please see the blog post for full details.

                                                                                                          To access the API you must provide a custom media type in the Accept header:

                                                                                                            application/vnd.github.squirrel-girl-preview
                                                                                                          

                                                                                                          The reactions key will have the following payload where url can be used to construct the API location for listing and creating reactions.

                                                                                                          {
                                                                                                            "total_count": 5,
                                                                                                            "+1": 3,
                                                                                                            "-1": 1,
                                                                                                            "laugh": 0,
                                                                                                            "confused": 0,
                                                                                                            "heart": 1,
                                                                                                            "hooray": 0,
                                                                                                            "url": "https://api.github.com/repos/octocat/Hello-World/pulls/comments/1/reactions"
                                                                                                          }
                                                                                                          

                                                                                                          List comments in a repository

                                                                                                          GET /repos/:owner/:repo/pulls/comments
                                                                                                          

                                                                                                          By default, review comments are ordered by ascending ID.

                                                                                                          Parameters

                                                                                                          Name Type Description
                                                                                                          sort string Can be either created or updated comments. Default: created
                                                                                                          direction string Can be either asc or desc. Ignored without sort parameter.
                                                                                                          since string This is a timestamp in ISO 8601 format: YYYY-MM-DDTHH:MM:SSZ. Only returns comments updated at or after this time.

                                                                                                          Response

                                                                                                          Status: 200 OK
                                                                                                          Link: <https://api.github.com/resource?page=2>; rel="next",
                                                                                                                <https://api.github.com/resource?page=5>; rel="last"
                                                                                                          
                                                                                                          [
                                                                                                            {
                                                                                                              "url": "https://api.github.com/repos/octocat/Hello-World/pulls/comments/1",
                                                                                                              "id": 10,
                                                                                                              "pull_request_review_id": 42,
                                                                                                              "diff_hunk": "@@ -16,33 +16,40 @@ public class Connection : IConnection...",
                                                                                                              "path": "file1.txt",
                                                                                                              "position": 1,
                                                                                                              "original_position": 4,
                                                                                                              "commit_id": "6dcb09b5b57875f334f61aebed695e2e4193db5e",
                                                                                                              "original_commit_id": "9c48853fa3dc5c1c3d6f1f1cd1f2743e72652840",
                                                                                                              "in_reply_to_id": 8,
                                                                                                              "user": {
                                                                                                                "login": "octocat",
                                                                                                                "id": 1,
                                                                                                                "avatar_url": "https://github.com/images/error/octocat_happy.gif",
                                                                                                                "gravatar_id": "",
                                                                                                                "url": "https://api.github.com/users/octocat",
                                                                                                                "html_url": "https://github.com/octocat",
                                                                                                                "followers_url": "https://api.github.com/users/octocat/followers",
                                                                                                                "following_url": "https://api.github.com/users/octocat/following{/other_user}",
                                                                                                                "gists_url": "https://api.github.com/users/octocat/gists{/gist_id}",
                                                                                                                "starred_url": "https://api.github.com/users/octocat/starred{/owner}{/repo}",
                                                                                                                "subscriptions_url": "https://api.github.com/users/octocat/subscriptions",
                                                                                                                "organizations_url": "https://api.github.com/users/octocat/orgs",
                                                                                                                "repos_url": "https://api.github.com/users/octocat/repos",
                                                                                                                "events_url": "https://api.github.com/users/octocat/events{/privacy}",
                                                                                                                "received_events_url": "https://api.github.com/users/octocat/received_events",
                                                                                                                "type": "User",
                                                                                                                "site_admin": false
                                                                                                              },
                                                                                                              "body": "Great stuff",
                                                                                                              "created_at": "2011-04-14T16:00:49Z",
                                                                                                              "updated_at": "2011-04-14T16:00:49Z",
                                                                                                              "html_url": "https://github.com/octocat/Hello-World/pull/1#discussion-diff-1",
                                                                                                              "pull_request_url": "https://api.github.com/repos/octocat/Hello-World/pulls/1",
                                                                                                              "_links": {
                                                                                                                "self": {
                                                                                                                  "href": "https://api.github.com/repos/octocat/Hello-World/pulls/comments/1"
                                                                                                                },
                                                                                                                "html": {
                                                                                                                  "href": "https://github.com/octocat/Hello-World/pull/1#discussion-diff-1"
                                                                                                                },
                                                                                                                "pull_request": {
                                                                                                                  "href": "https://api.github.com/repos/octocat/Hello-World/pulls/1"
                                                                                                                }
                                                                                                              }
                                                                                                            }
                                                                                                          ]
                                                                                                          

                                                                                                          Reactions summary

                                                                                                          An additional reactions object in the review comment payload is currently available for developers to preview. During the preview period, the APIs may change without advance notice. Please see the blog post for full details.

                                                                                                          To access the API you must provide a custom media type in the Accept header:

                                                                                                            application/vnd.github.squirrel-girl-preview
                                                                                                          

                                                                                                          The reactions key will have the following payload where url can be used to construct the API location for listing and creating reactions.

                                                                                                          {
                                                                                                            "total_count": 5,
                                                                                                            "+1": 3,
                                                                                                            "-1": 1,
                                                                                                            "laugh": 0,
                                                                                                            "confused": 0,
                                                                                                            "heart": 1,
                                                                                                            "hooray": 0,
                                                                                                            "url": "https://api.github.com/repos/octocat/Hello-World/pulls/comments/1/reactions"
                                                                                                          }
                                                                                                          

                                                                                                          Get a single comment

                                                                                                          GET /repos/:owner/:repo/pulls/comments/:id
                                                                                                          

                                                                                                          Response

                                                                                                          Status: 200 OK
                                                                                                          
                                                                                                          {
                                                                                                            "url": "https://api.github.com/repos/octocat/Hello-World/pulls/comments/1",
                                                                                                            "id": 10,
                                                                                                            "pull_request_review_id": 42,
                                                                                                            "diff_hunk": "@@ -16,33 +16,40 @@ public class Connection : IConnection...",
                                                                                                            "path": "file1.txt",
                                                                                                            "position": 1,
                                                                                                            "original_position": 4,
                                                                                                            "commit_id": "6dcb09b5b57875f334f61aebed695e2e4193db5e",
                                                                                                            "original_commit_id": "9c48853fa3dc5c1c3d6f1f1cd1f2743e72652840",
                                                                                                            "in_reply_to_id": 8,
                                                                                                            "user": {
                                                                                                              "login": "octocat",
                                                                                                              "id": 1,
                                                                                                              "avatar_url": "https://github.com/images/error/octocat_happy.gif",
                                                                                                              "gravatar_id": "",
                                                                                                              "url": "https://api.github.com/users/octocat",
                                                                                                              "html_url": "https://github.com/octocat",
                                                                                                              "followers_url": "https://api.github.com/users/octocat/followers",
                                                                                                              "following_url": "https://api.github.com/users/octocat/following{/other_user}",
                                                                                                              "gists_url": "https://api.github.com/users/octocat/gists{/gist_id}",
                                                                                                              "starred_url": "https://api.github.com/users/octocat/starred{/owner}{/repo}",
                                                                                                              "subscriptions_url": "https://api.github.com/users/octocat/subscriptions",
                                                                                                              "organizations_url": "https://api.github.com/users/octocat/orgs",
                                                                                                              "repos_url": "https://api.github.com/users/octocat/repos",
                                                                                                              "events_url": "https://api.github.com/users/octocat/events{/privacy}",
                                                                                                              "received_events_url": "https://api.github.com/users/octocat/received_events",
                                                                                                              "type": "User",
                                                                                                              "site_admin": false
                                                                                                            },
                                                                                                            "body": "Great stuff",
                                                                                                            "created_at": "2011-04-14T16:00:49Z",
                                                                                                            "updated_at": "2011-04-14T16:00:49Z",
                                                                                                            "html_url": "https://github.com/octocat/Hello-World/pull/1#discussion-diff-1",
                                                                                                            "pull_request_url": "https://api.github.com/repos/octocat/Hello-World/pulls/1",
                                                                                                            "_links": {
                                                                                                              "self": {
                                                                                                                "href": "https://api.github.com/repos/octocat/Hello-World/pulls/comments/1"
                                                                                                              },
                                                                                                              "html": {
                                                                                                                "href": "https://github.com/octocat/Hello-World/pull/1#discussion-diff-1"
                                                                                                              },
                                                                                                              "pull_request": {
                                                                                                                "href": "https://api.github.com/repos/octocat/Hello-World/pulls/1"
                                                                                                              }
                                                                                                            }
                                                                                                          }
                                                                                                          

                                                                                                          Reactions summary

                                                                                                          An additional reactions object in the review comment payload is currently available for developers to preview. During the preview period, the APIs may change without advance notice. Please see the blog post for full details.

                                                                                                          To access the API you must provide a custom media type in the Accept header:

                                                                                                            application/vnd.github.squirrel-girl-preview
                                                                                                          

                                                                                                          The reactions key will have the following payload where url can be used to construct the API location for listing and creating reactions.

                                                                                                          {
                                                                                                            "total_count": 5,
                                                                                                            "+1": 3,
                                                                                                            "-1": 1,
                                                                                                            "laugh": 0,
                                                                                                            "confused": 0,
                                                                                                            "heart": 1,
                                                                                                            "hooray": 0,
                                                                                                            "url": "https://api.github.com/repos/octocat/Hello-World/pulls/comments/1/reactions"
                                                                                                          }
                                                                                                          

                                                                                                          Create a comment

                                                                                                          POST /repos/:owner/:repo/pulls/:number/comments
                                                                                                          

                                                                                                          Input

                                                                                                          Name Type Description
                                                                                                          body string Required. The text of the comment.
                                                                                                          commit_id string Required. The SHA of the commit needing a comment. Not using the latest commit SHA may render your comment outdated if a subsequent commit modifies the line you specify as the position.
                                                                                                          path string Required. The relative path to the file that necessitates a comment.
                                                                                                          position integer Required. The position in the diff where you want to add a review comment. Note this value is not the same as the line number in the file. For help finding the position value, read the note below.

                                                                                                          Note: To comment on a specific line in a file, you need to first determine the position of that line in the diff. The GitHub REST API v3 offers the application/vnd.github.v3.diff media type. To see a pull request diff, add this media type to the Accept header of a call to the single pull request endpoint.

                                                                                                          The position value equals the number of lines down from the first "@@" hunk header in the file you want to add a comment. The line just below the "@@" line is position 1, the next line is position 2, and so on. The position in the diff continues to increase through lines of whitespace and additional hunks until the beginning of a new file.

                                                                                                          Example

                                                                                                          {
                                                                                                            "body": "Nice change",
                                                                                                            "commit_id": "6dcb09b5b57875f334f61aebed695e2e4193db5e",
                                                                                                            "path": "file1.txt",
                                                                                                            "position": 4
                                                                                                          }
                                                                                                          

                                                                                                          Alternative Input

                                                                                                          Instead of passing commit_id, path, and position, you can reply to an existing pull request comment like this:

                                                                                                          Name Type Description
                                                                                                          body string Required. The text of the comment.
                                                                                                          in_reply_to integer Required. The comment ID to reply to. Note: This must be the ID of a top-level comment, not a reply to that comment. Replies to replies are not supported.

                                                                                                          Example

                                                                                                          {
                                                                                                            "body": "Nice change",
                                                                                                            "in_reply_to": 4
                                                                                                          }
                                                                                                          

                                                                                                          Response

                                                                                                          Status: 201 Created
                                                                                                          Location: https://api.github.com/repos/octocat/Hello-World/pulls/comments/1
                                                                                                          
                                                                                                          {
                                                                                                            "url": "https://api.github.com/repos/octocat/Hello-World/pulls/comments/1",
                                                                                                            "id": 10,
                                                                                                            "pull_request_review_id": 42,
                                                                                                            "diff_hunk": "@@ -16,33 +16,40 @@ public class Connection : IConnection...",
                                                                                                            "path": "file1.txt",
                                                                                                            "position": 1,
                                                                                                            "original_position": 4,
                                                                                                            "commit_id": "6dcb09b5b57875f334f61aebed695e2e4193db5e",
                                                                                                            "original_commit_id": "9c48853fa3dc5c1c3d6f1f1cd1f2743e72652840",
                                                                                                            "in_reply_to_id": 8,
                                                                                                            "user": {
                                                                                                              "login": "octocat",
                                                                                                              "id": 1,
                                                                                                              "avatar_url": "https://github.com/images/error/octocat_happy.gif",
                                                                                                              "gravatar_id": "",
                                                                                                              "url": "https://api.github.com/users/octocat",
                                                                                                              "html_url": "https://github.com/octocat",
                                                                                                              "followers_url": "https://api.github.com/users/octocat/followers",
                                                                                                              "following_url": "https://api.github.com/users/octocat/following{/other_user}",
                                                                                                              "gists_url": "https://api.github.com/users/octocat/gists{/gist_id}",
                                                                                                              "starred_url": "https://api.github.com/users/octocat/starred{/owner}{/repo}",
                                                                                                              "subscriptions_url": "https://api.github.com/users/octocat/subscriptions",
                                                                                                              "organizations_url": "https://api.github.com/users/octocat/orgs",
                                                                                                              "repos_url": "https://api.github.com/users/octocat/repos",
                                                                                                              "events_url": "https://api.github.com/users/octocat/events{/privacy}",
                                                                                                              "received_events_url": "https://api.github.com/users/octocat/received_events",
                                                                                                              "type": "User",
                                                                                                              "site_admin": false
                                                                                                            },
                                                                                                            "body": "Great stuff",
                                                                                                            "created_at": "2011-04-14T16:00:49Z",
                                                                                                            "updated_at": "2011-04-14T16:00:49Z",
                                                                                                            "html_url": "https://github.com/octocat/Hello-World/pull/1#discussion-diff-1",
                                                                                                            "pull_request_url": "https://api.github.com/repos/octocat/Hello-World/pulls/1",
                                                                                                            "_links": {
                                                                                                              "self": {
                                                                                                                "href": "https://api.github.com/repos/octocat/Hello-World/pulls/comments/1"
                                                                                                              },
                                                                                                              "html": {
                                                                                                                "href": "https://github.com/octocat/Hello-World/pull/1#discussion-diff-1"
                                                                                                              },
                                                                                                              "pull_request": {
                                                                                                                "href": "https://api.github.com/repos/octocat/Hello-World/pulls/1"
                                                                                                              }
                                                                                                            }
                                                                                                          }
                                                                                                          

                                                                                                          Edit a comment

                                                                                                          PATCH /repos/:owner/:repo/pulls/comments/:id
                                                                                                          

                                                                                                          Input

                                                                                                          Name Type Description
                                                                                                          body string Required. The text of the comment.

                                                                                                          Example

                                                                                                          {
                                                                                                            "body": "Nice change"
                                                                                                          }
                                                                                                          

                                                                                                          Response

                                                                                                          Status: 200 OK
                                                                                                          
                                                                                                          {
                                                                                                            "url": "https://api.github.com/repos/octocat/Hello-World/pulls/comments/1",
                                                                                                            "id": 10,
                                                                                                            "pull_request_review_id": 42,
                                                                                                            "diff_hunk": "@@ -16,33 +16,40 @@ public class Connection : IConnection...",
                                                                                                            "path": "file1.txt",
                                                                                                            "position": 1,
                                                                                                            "original_position": 4,
                                                                                                            "commit_id": "6dcb09b5b57875f334f61aebed695e2e4193db5e",
                                                                                                            "original_commit_id": "9c48853fa3dc5c1c3d6f1f1cd1f2743e72652840",
                                                                                                            "in_reply_to_id": 8,
                                                                                                            "user": {
                                                                                                              "login": "octocat",
                                                                                                              "id": 1,
                                                                                                              "avatar_url": "https://github.com/images/error/octocat_happy.gif",
                                                                                                              "gravatar_id": "",
                                                                                                              "url": "https://api.github.com/users/octocat",
                                                                                                              "html_url": "https://github.com/octocat",
                                                                                                              "followers_url": "https://api.github.com/users/octocat/followers",
                                                                                                              "following_url": "https://api.github.com/users/octocat/following{/other_user}",
                                                                                                              "gists_url": "https://api.github.com/users/octocat/gists{/gist_id}",
                                                                                                              "starred_url": "https://api.github.com/users/octocat/starred{/owner}{/repo}",
                                                                                                              "subscriptions_url": "https://api.github.com/users/octocat/subscriptions",
                                                                                                              "organizations_url": "https://api.github.com/users/octocat/orgs",
                                                                                                              "repos_url": "https://api.github.com/users/octocat/repos",
                                                                                                              "events_url": "https://api.github.com/users/octocat/events{/privacy}",
                                                                                                              "received_events_url": "https://api.github.com/users/octocat/received_events",
                                                                                                              "type": "User",
                                                                                                              "site_admin": false
                                                                                                            },
                                                                                                            "body": "Great stuff",
                                                                                                            "created_at": "2011-04-14T16:00:49Z",
                                                                                                            "updated_at": "2011-04-14T16:00:49Z",
                                                                                                            "html_url": "https://github.com/octocat/Hello-World/pull/1#discussion-diff-1",
                                                                                                            "pull_request_url": "https://api.github.com/repos/octocat/Hello-World/pulls/1",
                                                                                                            "_links": {
                                                                                                              "self": {
                                                                                                                "href": "https://api.github.com/repos/octocat/Hello-World/pulls/comments/1"
                                                                                                              },
                                                                                                              "html": {
                                                                                                                "href": "https://github.com/octocat/Hello-World/pull/1#discussion-diff-1"
                                                                                                              },
                                                                                                              "pull_request": {
                                                                                                                "href": "https://api.github.com/repos/octocat/Hello-World/pulls/1"
                                                                                                              }
                                                                                                            }
                                                                                                          }
                                                                                                          

                                                                                                          Delete a comment

                                                                                                          DELETE /repos/:owner/:repo/pulls/comments/:id
                                                                                                          

                                                                                                          Response

                                                                                                          Status: 204 No Content
                                                                                                          

                                                                                                          Custom media types

                                                                                                          These are the supported media types for pull request review comments. You can read more about the use of media types in the API here.

                                                                                                          application/vnd.github.VERSION.raw+json
                                                                                                          application/vnd.github.VERSION.text+json
                                                                                                          application/vnd.github.VERSION.html+json
                                                                                                          application/vnd.github.VERSION.full+json
                                                                                                          
                                                                                                          tmp/developer.github.com/v3/pulls/review_requests/index.html Review Requests | GitHub Developer Guide

                                                                                                          Review Requests

                                                                                                          Pull request authors and repository owners and collaborators can request a pull request review from anyone with write access to the repository. Each requested reviewer will receive a notification asking them to review the pull request.

                                                                                                          List review requests

                                                                                                          GET /repos/:owner/:repo/pulls/:number/requested_reviewers
                                                                                                          

                                                                                                          Response

                                                                                                          Status: 200 OK
                                                                                                          Link: <https://api.github.com/resource?page=2>; rel="next",
                                                                                                                <https://api.github.com/resource?page=5>; rel="last"
                                                                                                          
                                                                                                          {
                                                                                                            "users": [
                                                                                                              {
                                                                                                                "login": "octocat",
                                                                                                                "id": 1,
                                                                                                                "avatar_url": "https://github.com/images/error/octocat_happy.gif",
                                                                                                                "gravatar_id": "",
                                                                                                                "url": "https://api.github.com/users/octocat",
                                                                                                                "html_url": "https://github.com/octocat",
                                                                                                                "followers_url": "https://api.github.com/users/octocat/followers",
                                                                                                                "following_url": "https://api.github.com/users/octocat/following{/other_user}",
                                                                                                                "gists_url": "https://api.github.com/users/octocat/gists{/gist_id}",
                                                                                                                "starred_url": "https://api.github.com/users/octocat/starred{/owner}{/repo}",
                                                                                                                "subscriptions_url": "https://api.github.com/users/octocat/subscriptions",
                                                                                                                "organizations_url": "https://api.github.com/users/octocat/orgs",
                                                                                                                "repos_url": "https://api.github.com/users/octocat/repos",
                                                                                                                "events_url": "https://api.github.com/users/octocat/events{/privacy}",
                                                                                                                "received_events_url": "https://api.github.com/users/octocat/received_events",
                                                                                                                "type": "User",
                                                                                                                "site_admin": false
                                                                                                              }
                                                                                                            ],
                                                                                                            "teams": [
                                                                                                              {
                                                                                                                "id": 1,
                                                                                                                "url": "https://api.github.com/teams/1",
                                                                                                                "name": "Justice League",
                                                                                                                "slug": "justice-league",
                                                                                                                "description": "A great team.",
                                                                                                                "privacy": "closed",
                                                                                                                "permission": "admin",
                                                                                                                "members_url": "https://api.github.com/teams/1/members{/member}",
                                                                                                                "repositories_url": "https://api.github.com/teams/1/repos"
                                                                                                              }
                                                                                                            ]
                                                                                                          }
                                                                                                          

                                                                                                          Create a review request

                                                                                                          POST /repos/:owner/:repo/pulls/:number/requested_reviewers
                                                                                                          

                                                                                                          Input

                                                                                                          Name Type Description
                                                                                                          reviewers array of strings An array of user logins that will be requested.
                                                                                                          team_reviewers array of strings An array of team slugs that will be requested.

                                                                                                          Example

                                                                                                          {
                                                                                                            "reviewers": [
                                                                                                              "octocat",
                                                                                                              "hubot",
                                                                                                              "other_user"
                                                                                                            ],
                                                                                                            "team_reviewers": [
                                                                                                              "justice-league"
                                                                                                            ]
                                                                                                          }
                                                                                                          

                                                                                                          Response if user is not a collaborator

                                                                                                          Status: 422 Unprocessable Entity
                                                                                                          

                                                                                                          Response

                                                                                                          Status: 201 Created
                                                                                                          
                                                                                                          {
                                                                                                            "id": 1,
                                                                                                            "url": "https://api.github.com/repos/octocat/Hello-World/pulls/1347",
                                                                                                            "html_url": "https://github.com/octocat/Hello-World/pull/1347",
                                                                                                            "diff_url": "https://github.com/octocat/Hello-World/pull/1347.diff",
                                                                                                            "patch_url": "https://github.com/octocat/Hello-World/pull/1347.patch",
                                                                                                            "issue_url": "https://api.github.com/repos/octocat/Hello-World/issues/1347",
                                                                                                            "commits_url": "https://api.github.com/repos/octocat/Hello-World/pulls/1347/commits",
                                                                                                            "review_comments_url": "https://api.github.com/repos/octocat/Hello-World/pulls/1347/comments",
                                                                                                            "review_comment_url": "https://api.github.com/repos/octocat/Hello-World/pulls/comments{/number}",
                                                                                                            "comments_url": "https://api.github.com/repos/octocat/Hello-World/issues/1347/comments",
                                                                                                            "statuses_url": "https://api.github.com/repos/octocat/Hello-World/statuses/6dcb09b5b57875f334f61aebed695e2e4193db5e",
                                                                                                            "number": 1347,
                                                                                                            "state": "open",
                                                                                                            "title": "new-feature",
                                                                                                            "body": "Please pull these awesome changes",
                                                                                                            "assignee": {
                                                                                                              "login": "octocat",
                                                                                                              "id": 1,
                                                                                                              "avatar_url": "https://github.com/images/error/octocat_happy.gif",
                                                                                                              "gravatar_id": "",
                                                                                                              "url": "https://api.github.com/users/octocat",
                                                                                                              "html_url": "https://github.com/octocat",
                                                                                                              "followers_url": "https://api.github.com/users/octocat/followers",
                                                                                                              "following_url": "https://api.github.com/users/octocat/following{/other_user}",
                                                                                                              "gists_url": "https://api.github.com/users/octocat/gists{/gist_id}",
                                                                                                              "starred_url": "https://api.github.com/users/octocat/starred{/owner}{/repo}",
                                                                                                              "subscriptions_url": "https://api.github.com/users/octocat/subscriptions",
                                                                                                              "organizations_url": "https://api.github.com/users/octocat/orgs",
                                                                                                              "repos_url": "https://api.github.com/users/octocat/repos",
                                                                                                              "events_url": "https://api.github.com/users/octocat/events{/privacy}",
                                                                                                              "received_events_url": "https://api.github.com/users/octocat/received_events",
                                                                                                              "type": "User",
                                                                                                              "site_admin": false
                                                                                                            },
                                                                                                            "milestone": {
                                                                                                              "url": "https://api.github.com/repos/octocat/Hello-World/milestones/1",
                                                                                                              "html_url": "https://github.com/octocat/Hello-World/milestones/v1.0",
                                                                                                              "labels_url": "https://api.github.com/repos/octocat/Hello-World/milestones/1/labels",
                                                                                                              "id": 1002604,
                                                                                                              "number": 1,
                                                                                                              "state": "open",
                                                                                                              "title": "v1.0",
                                                                                                              "description": "Tracking milestone for version 1.0",
                                                                                                              "creator": {
                                                                                                                "login": "octocat",
                                                                                                                "id": 1,
                                                                                                                "avatar_url": "https://github.com/images/error/octocat_happy.gif",
                                                                                                                "gravatar_id": "",
                                                                                                                "url": "https://api.github.com/users/octocat",
                                                                                                                "html_url": "https://github.com/octocat",
                                                                                                                "followers_url": "https://api.github.com/users/octocat/followers",
                                                                                                                "following_url": "https://api.github.com/users/octocat/following{/other_user}",
                                                                                                                "gists_url": "https://api.github.com/users/octocat/gists{/gist_id}",
                                                                                                                "starred_url": "https://api.github.com/users/octocat/starred{/owner}{/repo}",
                                                                                                                "subscriptions_url": "https://api.github.com/users/octocat/subscriptions",
                                                                                                                "organizations_url": "https://api.github.com/users/octocat/orgs",
                                                                                                                "repos_url": "https://api.github.com/users/octocat/repos",
                                                                                                                "events_url": "https://api.github.com/users/octocat/events{/privacy}",
                                                                                                                "received_events_url": "https://api.github.com/users/octocat/received_events",
                                                                                                                "type": "User",
                                                                                                                "site_admin": false
                                                                                                              },
                                                                                                              "open_issues": 4,
                                                                                                              "closed_issues": 8,
                                                                                                              "created_at": "2011-04-10T20:09:31Z",
                                                                                                              "updated_at": "2014-03-03T18:58:10Z",
                                                                                                              "closed_at": "2013-02-12T13:22:01Z",
                                                                                                              "due_on": "2012-10-09T23:39:01Z"
                                                                                                            },
                                                                                                            "locked": true,
                                                                                                            "active_lock_reason": "too heated",
                                                                                                            "created_at": "2011-01-26T19:01:12Z",
                                                                                                            "updated_at": "2011-01-26T19:01:12Z",
                                                                                                            "closed_at": "2011-01-26T19:01:12Z",
                                                                                                            "merged_at": "2011-01-26T19:01:12Z",
                                                                                                            "head": {
                                                                                                              "label": "new-topic",
                                                                                                              "ref": "new-topic",
                                                                                                              "sha": "6dcb09b5b57875f334f61aebed695e2e4193db5e",
                                                                                                              "user": {
                                                                                                                "login": "octocat",
                                                                                                                "id": 1,
                                                                                                                "avatar_url": "https://github.com/images/error/octocat_happy.gif",
                                                                                                                "gravatar_id": "",
                                                                                                                "url": "https://api.github.com/users/octocat",
                                                                                                                "html_url": "https://github.com/octocat",
                                                                                                                "followers_url": "https://api.github.com/users/octocat/followers",
                                                                                                                "following_url": "https://api.github.com/users/octocat/following{/other_user}",
                                                                                                                "gists_url": "https://api.github.com/users/octocat/gists{/gist_id}",
                                                                                                                "starred_url": "https://api.github.com/users/octocat/starred{/owner}{/repo}",
                                                                                                                "subscriptions_url": "https://api.github.com/users/octocat/subscriptions",
                                                                                                                "organizations_url": "https://api.github.com/users/octocat/orgs",
                                                                                                                "repos_url": "https://api.github.com/users/octocat/repos",
                                                                                                                "events_url": "https://api.github.com/users/octocat/events{/privacy}",
                                                                                                                "received_events_url": "https://api.github.com/users/octocat/received_events",
                                                                                                                "type": "User",
                                                                                                                "site_admin": false
                                                                                                              },
                                                                                                              "repo": {
                                                                                                                "id": 1296269,
                                                                                                                "owner": {
                                                                                                                  "login": "octocat",
                                                                                                                  "id": 1,
                                                                                                                  "avatar_url": "https://github.com/images/error/octocat_happy.gif",
                                                                                                                  "gravatar_id": "",
                                                                                                                  "url": "https://api.github.com/users/octocat",
                                                                                                                  "html_url": "https://github.com/octocat",
                                                                                                                  "followers_url": "https://api.github.com/users/octocat/followers",
                                                                                                                  "following_url": "https://api.github.com/users/octocat/following{/other_user}",
                                                                                                                  "gists_url": "https://api.github.com/users/octocat/gists{/gist_id}",
                                                                                                                  "starred_url": "https://api.github.com/users/octocat/starred{/owner}{/repo}",
                                                                                                                  "subscriptions_url": "https://api.github.com/users/octocat/subscriptions",
                                                                                                                  "organizations_url": "https://api.github.com/users/octocat/orgs",
                                                                                                                  "repos_url": "https://api.github.com/users/octocat/repos",
                                                                                                                  "events_url": "https://api.github.com/users/octocat/events{/privacy}",
                                                                                                                  "received_events_url": "https://api.github.com/users/octocat/received_events",
                                                                                                                  "type": "User",
                                                                                                                  "site_admin": false
                                                                                                                },
                                                                                                                "name": "Hello-World",
                                                                                                                "full_name": "octocat/Hello-World",
                                                                                                                "description": "This your first repo!",
                                                                                                                "private": false,
                                                                                                                "fork": false,
                                                                                                                "url": "https://api.github.com/repos/octocat/Hello-World",
                                                                                                                "html_url": "https://github.com/octocat/Hello-World",
                                                                                                                "archive_url": "http://api.github.com/repos/octocat/Hello-World/{archive_format}{/ref}",
                                                                                                                "assignees_url": "http://api.github.com/repos/octocat/Hello-World/assignees{/user}",
                                                                                                                "blobs_url": "http://api.github.com/repos/octocat/Hello-World/git/blobs{/sha}",
                                                                                                                "branches_url": "http://api.github.com/repos/octocat/Hello-World/branches{/branch}",
                                                                                                                "clone_url": "https://github.com/octocat/Hello-World.git",
                                                                                                                "collaborators_url": "http://api.github.com/repos/octocat/Hello-World/collaborators{/collaborator}",
                                                                                                                "comments_url": "http://api.github.com/repos/octocat/Hello-World/comments{/number}",
                                                                                                                "commits_url": "http://api.github.com/repos/octocat/Hello-World/commits{/sha}",
                                                                                                                "compare_url": "http://api.github.com/repos/octocat/Hello-World/compare/{base}...{head}",
                                                                                                                "contents_url": "http://api.github.com/repos/octocat/Hello-World/contents/{+path}",
                                                                                                                "contributors_url": "http://api.github.com/repos/octocat/Hello-World/contributors",
                                                                                                                "deployments_url": "http://api.github.com/repos/octocat/Hello-World/deployments",
                                                                                                                "downloads_url": "http://api.github.com/repos/octocat/Hello-World/downloads",
                                                                                                                "events_url": "http://api.github.com/repos/octocat/Hello-World/events",
                                                                                                                "forks_url": "http://api.github.com/repos/octocat/Hello-World/forks",
                                                                                                                "git_commits_url": "http://api.github.com/repos/octocat/Hello-World/git/commits{/sha}",
                                                                                                                "git_refs_url": "http://api.github.com/repos/octocat/Hello-World/git/refs{/sha}",
                                                                                                                "git_tags_url": "http://api.github.com/repos/octocat/Hello-World/git/tags{/sha}",
                                                                                                                "git_url": "git:github.com/octocat/Hello-World.git",
                                                                                                                "hooks_url": "http://api.github.com/repos/octocat/Hello-World/hooks",
                                                                                                                "issue_comment_url": "http://api.github.com/repos/octocat/Hello-World/issues/comments{/number}",
                                                                                                                "issue_events_url": "http://api.github.com/repos/octocat/Hello-World/issues/events{/number}",
                                                                                                                "issues_url": "http://api.github.com/repos/octocat/Hello-World/issues{/number}",
                                                                                                                "keys_url": "http://api.github.com/repos/octocat/Hello-World/keys{/key_id}",
                                                                                                                "labels_url": "http://api.github.com/repos/octocat/Hello-World/labels{/name}",
                                                                                                                "languages_url": "http://api.github.com/repos/octocat/Hello-World/languages",
                                                                                                                "merges_url": "http://api.github.com/repos/octocat/Hello-World/merges",
                                                                                                                "milestones_url": "http://api.github.com/repos/octocat/Hello-World/milestones{/number}",
                                                                                                                "mirror_url": "git:git.example.com/octocat/Hello-World",
                                                                                                                "notifications_url": "http://api.github.com/repos/octocat/Hello-World/notifications{?since,all,participating}",
                                                                                                                "pulls_url": "http://api.github.com/repos/octocat/Hello-World/pulls{/number}",
                                                                                                                "releases_url": "http://api.github.com/repos/octocat/Hello-World/releases{/id}",
                                                                                                                "ssh_url": "git@github.com:octocat/Hello-World.git",
                                                                                                                "stargazers_url": "http://api.github.com/repos/octocat/Hello-World/stargazers",
                                                                                                                "statuses_url": "http://api.github.com/repos/octocat/Hello-World/statuses/{sha}",
                                                                                                                "subscribers_url": "http://api.github.com/repos/octocat/Hello-World/subscribers",
                                                                                                                "subscription_url": "http://api.github.com/repos/octocat/Hello-World/subscription",
                                                                                                                "svn_url": "https://svn.github.com/octocat/Hello-World",
                                                                                                                "tags_url": "http://api.github.com/repos/octocat/Hello-World/tags",
                                                                                                                "teams_url": "http://api.github.com/repos/octocat/Hello-World/teams",
                                                                                                                "trees_url": "http://api.github.com/repos/octocat/Hello-World/git/trees{/sha}",
                                                                                                                "homepage": "https://github.com",
                                                                                                                "language": null,
                                                                                                                "forks_count": 9,
                                                                                                                "stargazers_count": 80,
                                                                                                                "watchers_count": 80,
                                                                                                                "size": 108,
                                                                                                                "default_branch": "master",
                                                                                                                "open_issues_count": 0,
                                                                                                                "topics": [
                                                                                                                  "octocat",
                                                                                                                  "atom",
                                                                                                                  "electron",
                                                                                                                  "API"
                                                                                                                ],
                                                                                                                "has_issues": true,
                                                                                                                "has_wiki": true,
                                                                                                                "has_pages": false,
                                                                                                                "has_downloads": true,
                                                                                                                "archived": false,
                                                                                                                "pushed_at": "2011-01-26T19:06:43Z",
                                                                                                                "created_at": "2011-01-26T19:01:12Z",
                                                                                                                "updated_at": "2011-01-26T19:14:43Z",
                                                                                                                "permissions": {
                                                                                                                  "admin": false,
                                                                                                                  "push": false,
                                                                                                                  "pull": true
                                                                                                                },
                                                                                                                "allow_rebase_merge": true,
                                                                                                                "allow_squash_merge": true,
                                                                                                                "allow_merge_commit": true,
                                                                                                                "subscribers_count": 42,
                                                                                                                "network_count": 0
                                                                                                              }
                                                                                                            },
                                                                                                            "base": {
                                                                                                              "label": "master",
                                                                                                              "ref": "master",
                                                                                                              "sha": "6dcb09b5b57875f334f61aebed695e2e4193db5e",
                                                                                                              "user": {
                                                                                                                "login": "octocat",
                                                                                                                "id": 1,
                                                                                                                "avatar_url": "https://github.com/images/error/octocat_happy.gif",
                                                                                                                "gravatar_id": "",
                                                                                                                "url": "https://api.github.com/users/octocat",
                                                                                                                "html_url": "https://github.com/octocat",
                                                                                                                "followers_url": "https://api.github.com/users/octocat/followers",
                                                                                                                "following_url": "https://api.github.com/users/octocat/following{/other_user}",
                                                                                                                "gists_url": "https://api.github.com/users/octocat/gists{/gist_id}",
                                                                                                                "starred_url": "https://api.github.com/users/octocat/starred{/owner}{/repo}",
                                                                                                                "subscriptions_url": "https://api.github.com/users/octocat/subscriptions",
                                                                                                                "organizations_url": "https://api.github.com/users/octocat/orgs",
                                                                                                                "repos_url": "https://api.github.com/users/octocat/repos",
                                                                                                                "events_url": "https://api.github.com/users/octocat/events{/privacy}",
                                                                                                                "received_events_url": "https://api.github.com/users/octocat/received_events",
                                                                                                                "type": "User",
                                                                                                                "site_admin": false
                                                                                                              },
                                                                                                              "repo": {
                                                                                                                "id": 1296269,
                                                                                                                "owner": {
                                                                                                                  "login": "octocat",
                                                                                                                  "id": 1,
                                                                                                                  "avatar_url": "https://github.com/images/error/octocat_happy.gif",
                                                                                                                  "gravatar_id": "",
                                                                                                                  "url": "https://api.github.com/users/octocat",
                                                                                                                  "html_url": "https://github.com/octocat",
                                                                                                                  "followers_url": "https://api.github.com/users/octocat/followers",
                                                                                                                  "following_url": "https://api.github.com/users/octocat/following{/other_user}",
                                                                                                                  "gists_url": "https://api.github.com/users/octocat/gists{/gist_id}",
                                                                                                                  "starred_url": "https://api.github.com/users/octocat/starred{/owner}{/repo}",
                                                                                                                  "subscriptions_url": "https://api.github.com/users/octocat/subscriptions",
                                                                                                                  "organizations_url": "https://api.github.com/users/octocat/orgs",
                                                                                                                  "repos_url": "https://api.github.com/users/octocat/repos",
                                                                                                                  "events_url": "https://api.github.com/users/octocat/events{/privacy}",
                                                                                                                  "received_events_url": "https://api.github.com/users/octocat/received_events",
                                                                                                                  "type": "User",
                                                                                                                  "site_admin": false
                                                                                                                },
                                                                                                                "name": "Hello-World",
                                                                                                                "full_name": "octocat/Hello-World",
                                                                                                                "description": "This your first repo!",
                                                                                                                "private": false,
                                                                                                                "fork": false,
                                                                                                                "url": "https://api.github.com/repos/octocat/Hello-World",
                                                                                                                "html_url": "https://github.com/octocat/Hello-World",
                                                                                                                "archive_url": "http://api.github.com/repos/octocat/Hello-World/{archive_format}{/ref}",
                                                                                                                "assignees_url": "http://api.github.com/repos/octocat/Hello-World/assignees{/user}",
                                                                                                                "blobs_url": "http://api.github.com/repos/octocat/Hello-World/git/blobs{/sha}",
                                                                                                                "branches_url": "http://api.github.com/repos/octocat/Hello-World/branches{/branch}",
                                                                                                                "clone_url": "https://github.com/octocat/Hello-World.git",
                                                                                                                "collaborators_url": "http://api.github.com/repos/octocat/Hello-World/collaborators{/collaborator}",
                                                                                                                "comments_url": "http://api.github.com/repos/octocat/Hello-World/comments{/number}",
                                                                                                                "commits_url": "http://api.github.com/repos/octocat/Hello-World/commits{/sha}",
                                                                                                                "compare_url": "http://api.github.com/repos/octocat/Hello-World/compare/{base}...{head}",
                                                                                                                "contents_url": "http://api.github.com/repos/octocat/Hello-World/contents/{+path}",
                                                                                                                "contributors_url": "http://api.github.com/repos/octocat/Hello-World/contributors",
                                                                                                                "deployments_url": "http://api.github.com/repos/octocat/Hello-World/deployments",
                                                                                                                "downloads_url": "http://api.github.com/repos/octocat/Hello-World/downloads",
                                                                                                                "events_url": "http://api.github.com/repos/octocat/Hello-World/events",
                                                                                                                "forks_url": "http://api.github.com/repos/octocat/Hello-World/forks",
                                                                                                                "git_commits_url": "http://api.github.com/repos/octocat/Hello-World/git/commits{/sha}",
                                                                                                                "git_refs_url": "http://api.github.com/repos/octocat/Hello-World/git/refs{/sha}",
                                                                                                                "git_tags_url": "http://api.github.com/repos/octocat/Hello-World/git/tags{/sha}",
                                                                                                                "git_url": "git:github.com/octocat/Hello-World.git",
                                                                                                                "hooks_url": "http://api.github.com/repos/octocat/Hello-World/hooks",
                                                                                                                "issue_comment_url": "http://api.github.com/repos/octocat/Hello-World/issues/comments{/number}",
                                                                                                                "issue_events_url": "http://api.github.com/repos/octocat/Hello-World/issues/events{/number}",
                                                                                                                "issues_url": "http://api.github.com/repos/octocat/Hello-World/issues{/number}",
                                                                                                                "keys_url": "http://api.github.com/repos/octocat/Hello-World/keys{/key_id}",
                                                                                                                "labels_url": "http://api.github.com/repos/octocat/Hello-World/labels{/name}",
                                                                                                                "languages_url": "http://api.github.com/repos/octocat/Hello-World/languages",
                                                                                                                "merges_url": "http://api.github.com/repos/octocat/Hello-World/merges",
                                                                                                                "milestones_url": "http://api.github.com/repos/octocat/Hello-World/milestones{/number}",
                                                                                                                "mirror_url": "git:git.example.com/octocat/Hello-World",
                                                                                                                "notifications_url": "http://api.github.com/repos/octocat/Hello-World/notifications{?since,all,participating}",
                                                                                                                "pulls_url": "http://api.github.com/repos/octocat/Hello-World/pulls{/number}",
                                                                                                                "releases_url": "http://api.github.com/repos/octocat/Hello-World/releases{/id}",
                                                                                                                "ssh_url": "git@github.com:octocat/Hello-World.git",
                                                                                                                "stargazers_url": "http://api.github.com/repos/octocat/Hello-World/stargazers",
                                                                                                                "statuses_url": "http://api.github.com/repos/octocat/Hello-World/statuses/{sha}",
                                                                                                                "subscribers_url": "http://api.github.com/repos/octocat/Hello-World/subscribers",
                                                                                                                "subscription_url": "http://api.github.com/repos/octocat/Hello-World/subscription",
                                                                                                                "svn_url": "https://svn.github.com/octocat/Hello-World",
                                                                                                                "tags_url": "http://api.github.com/repos/octocat/Hello-World/tags",
                                                                                                                "teams_url": "http://api.github.com/repos/octocat/Hello-World/teams",
                                                                                                                "trees_url": "http://api.github.com/repos/octocat/Hello-World/git/trees{/sha}",
                                                                                                                "homepage": "https://github.com",
                                                                                                                "language": null,
                                                                                                                "forks_count": 9,
                                                                                                                "stargazers_count": 80,
                                                                                                                "watchers_count": 80,
                                                                                                                "size": 108,
                                                                                                                "default_branch": "master",
                                                                                                                "open_issues_count": 0,
                                                                                                                "topics": [
                                                                                                                  "octocat",
                                                                                                                  "atom",
                                                                                                                  "electron",
                                                                                                                  "API"
                                                                                                                ],
                                                                                                                "has_issues": true,
                                                                                                                "has_wiki": true,
                                                                                                                "has_pages": false,
                                                                                                                "has_downloads": true,
                                                                                                                "archived": false,
                                                                                                                "pushed_at": "2011-01-26T19:06:43Z",
                                                                                                                "created_at": "2011-01-26T19:01:12Z",
                                                                                                                "updated_at": "2011-01-26T19:14:43Z",
                                                                                                                "permissions": {
                                                                                                                  "admin": false,
                                                                                                                  "push": false,
                                                                                                                  "pull": true
                                                                                                                },
                                                                                                                "allow_rebase_merge": true,
                                                                                                                "allow_squash_merge": true,
                                                                                                                "allow_merge_commit": true,
                                                                                                                "subscribers_count": 42,
                                                                                                                "network_count": 0
                                                                                                              }
                                                                                                            },
                                                                                                            "_links": {
                                                                                                              "self": {
                                                                                                                "href": "https://api.github.com/repos/octocat/Hello-World/pulls/1347"
                                                                                                              },
                                                                                                              "html": {
                                                                                                                "href": "https://github.com/octocat/Hello-World/pull/1347"
                                                                                                              },
                                                                                                              "issue": {
                                                                                                                "href": "https://api.github.com/repos/octocat/Hello-World/issues/1347"
                                                                                                              },
                                                                                                              "comments": {
                                                                                                                "href": "https://api.github.com/repos/octocat/Hello-World/issues/1347/comments"
                                                                                                              },
                                                                                                              "review_comments": {
                                                                                                                "href": "https://api.github.com/repos/octocat/Hello-World/pulls/1347/comments"
                                                                                                              },
                                                                                                              "review_comment": {
                                                                                                                "href": "https://api.github.com/repos/octocat/Hello-World/pulls/comments{/number}"
                                                                                                              },
                                                                                                              "commits": {
                                                                                                                "href": "https://api.github.com/repos/octocat/Hello-World/pulls/1347/commits"
                                                                                                              },
                                                                                                              "statuses": {
                                                                                                                "href": "https://api.github.com/repos/octocat/Hello-World/statuses/6dcb09b5b57875f334f61aebed695e2e4193db5e"
                                                                                                              }
                                                                                                            },
                                                                                                            "user": {
                                                                                                              "login": "octocat",
                                                                                                              "id": 1,
                                                                                                              "avatar_url": "https://github.com/images/error/octocat_happy.gif",
                                                                                                              "gravatar_id": "",
                                                                                                              "url": "https://api.github.com/users/octocat",
                                                                                                              "html_url": "https://github.com/octocat",
                                                                                                              "followers_url": "https://api.github.com/users/octocat/followers",
                                                                                                              "following_url": "https://api.github.com/users/octocat/following{/other_user}",
                                                                                                              "gists_url": "https://api.github.com/users/octocat/gists{/gist_id}",
                                                                                                              "starred_url": "https://api.github.com/users/octocat/starred{/owner}{/repo}",
                                                                                                              "subscriptions_url": "https://api.github.com/users/octocat/subscriptions",
                                                                                                              "organizations_url": "https://api.github.com/users/octocat/orgs",
                                                                                                              "repos_url": "https://api.github.com/users/octocat/repos",
                                                                                                              "events_url": "https://api.github.com/users/octocat/events{/privacy}",
                                                                                                              "received_events_url": "https://api.github.com/users/octocat/received_events",
                                                                                                              "type": "User",
                                                                                                              "site_admin": false
                                                                                                            },
                                                                                                            "requested_reviewers": [
                                                                                                              {
                                                                                                                "login": "octocat",
                                                                                                                "id": 1,
                                                                                                                "avatar_url": "https://github.com/images/error/octocat_happy.gif",
                                                                                                                "gravatar_id": "",
                                                                                                                "url": "https://api.github.com/users/octocat",
                                                                                                                "html_url": "https://github.com/octocat",
                                                                                                                "followers_url": "https://api.github.com/users/octocat/followers",
                                                                                                                "following_url": "https://api.github.com/users/octocat/following{/other_user}",
                                                                                                                "gists_url": "https://api.github.com/users/octocat/gists{/gist_id}",
                                                                                                                "starred_url": "https://api.github.com/users/octocat/starred{/owner}{/repo}",
                                                                                                                "subscriptions_url": "https://api.github.com/users/octocat/subscriptions",
                                                                                                                "organizations_url": "https://api.github.com/users/octocat/orgs",
                                                                                                                "repos_url": "https://api.github.com/users/octocat/repos",
                                                                                                                "events_url": "https://api.github.com/users/octocat/events{/privacy}",
                                                                                                                "received_events_url": "https://api.github.com/users/octocat/received_events",
                                                                                                                "type": "User",
                                                                                                                "site_admin": false
                                                                                                              },
                                                                                                              {
                                                                                                                "login": "hubot",
                                                                                                                "id": 1,
                                                                                                                "avatar_url": "https://github.com/images/error/hubot_happy.gif",
                                                                                                                "gravatar_id": "",
                                                                                                                "url": "https://api.github.com/users/hubot",
                                                                                                                "html_url": "https://github.com/hubot",
                                                                                                                "followers_url": "https://api.github.com/users/hubot/followers",
                                                                                                                "following_url": "https://api.github.com/users/hubot/following{/other_user}",
                                                                                                                "gists_url": "https://api.github.com/users/hubot/gists{/gist_id}",
                                                                                                                "starred_url": "https://api.github.com/users/hubot/starred{/owner}{/repo}",
                                                                                                                "subscriptions_url": "https://api.github.com/users/hubot/subscriptions",
                                                                                                                "organizations_url": "https://api.github.com/users/hubot/orgs",
                                                                                                                "repos_url": "https://api.github.com/users/hubot/repos",
                                                                                                                "events_url": "https://api.github.com/users/hubot/events{/privacy}",
                                                                                                                "received_events_url": "https://api.github.com/users/hubot/received_events",
                                                                                                                "type": "User",
                                                                                                                "site_admin": true
                                                                                                              },
                                                                                                              {
                                                                                                                "login": "other_user",
                                                                                                                "id": 1,
                                                                                                                "avatar_url": "https://github.com/images/error/other_user_happy.gif",
                                                                                                                "gravatar_id": "",
                                                                                                                "url": "https://api.github.com/users/other_user",
                                                                                                                "html_url": "https://github.com/other_user",
                                                                                                                "followers_url": "https://api.github.com/users/other_user/followers",
                                                                                                                "following_url": "https://api.github.com/users/other_user/following{/other_user}",
                                                                                                                "gists_url": "https://api.github.com/users/other_user/gists{/gist_id}",
                                                                                                                "starred_url": "https://api.github.com/users/other_user/starred{/owner}{/repo}",
                                                                                                                "subscriptions_url": "https://api.github.com/users/other_user/subscriptions",
                                                                                                                "organizations_url": "https://api.github.com/users/other_user/orgs",
                                                                                                                "repos_url": "https://api.github.com/users/other_user/repos",
                                                                                                                "events_url": "https://api.github.com/users/other_user/events{/privacy}",
                                                                                                                "received_events_url": "https://api.github.com/users/other_user/received_events",
                                                                                                                "type": "User",
                                                                                                                "site_admin": false
                                                                                                              }
                                                                                                            ],
                                                                                                            "requested_teams": [
                                                                                                              {
                                                                                                                "id": 1,
                                                                                                                "url": "https://api.github.com/teams/1",
                                                                                                                "name": "Justice League",
                                                                                                                "slug": "justice-league",
                                                                                                                "description": "A great team.",
                                                                                                                "privacy": "closed",
                                                                                                                "permission": "admin",
                                                                                                                "members_url": "https://api.github.com/teams/1/members{/member}",
                                                                                                                "repositories_url": "https://api.github.com/teams/1/repos"
                                                                                                              }
                                                                                                            ]
                                                                                                          }
                                                                                                          

                                                                                                          Delete a review request

                                                                                                          DELETE /repos/:owner/:repo/pulls/:number/requested_reviewers
                                                                                                          

                                                                                                          Input

                                                                                                          Name Type Description
                                                                                                          reviewers array of strings An array of user logins that will be removed.
                                                                                                          team_reviewers array of strings An array of team slugs that will be removed.

                                                                                                          Example

                                                                                                          {
                                                                                                            "reviewers": [
                                                                                                              "octocat",
                                                                                                              "hubot",
                                                                                                              "other_user"
                                                                                                            ],
                                                                                                            "team_reviewers": [
                                                                                                              "justice-league"
                                                                                                            ]
                                                                                                          }
                                                                                                          

                                                                                                          Response

                                                                                                          Status: 200 OK
                                                                                                          
                                                                                                          tmp/developer.github.com/v3/pulls/reviews/index.html Reviews | GitHub Developer Guide

                                                                                                          Reviews

                                                                                                          Pull Request Reviews are groups of Pull Request Review Comments on the Pull Request, grouped together with a state and optional body comment.

                                                                                                          List reviews on a pull request

                                                                                                          GET /repos/:owner/:repo/pulls/:number/reviews
                                                                                                          

                                                                                                          Response

                                                                                                          The list of reviews returns in chronological order.

                                                                                                          Status: 200 OK
                                                                                                          Link: <https://api.github.com/resource?page=2>; rel="next",
                                                                                                                <https://api.github.com/resource?page=5>; rel="last"
                                                                                                          
                                                                                                          [
                                                                                                            {
                                                                                                              "id": 80,
                                                                                                              "user": {
                                                                                                                "login": "octocat",
                                                                                                                "id": 1,
                                                                                                                "avatar_url": "https://github.com/images/error/octocat_happy.gif",
                                                                                                                "gravatar_id": "",
                                                                                                                "url": "https://api.github.com/users/octocat",
                                                                                                                "html_url": "https://github.com/octocat",
                                                                                                                "followers_url": "https://api.github.com/users/octocat/followers",
                                                                                                                "following_url": "https://api.github.com/users/octocat/following{/other_user}",
                                                                                                                "gists_url": "https://api.github.com/users/octocat/gists{/gist_id}",
                                                                                                                "starred_url": "https://api.github.com/users/octocat/starred{/owner}{/repo}",
                                                                                                                "subscriptions_url": "https://api.github.com/users/octocat/subscriptions",
                                                                                                                "organizations_url": "https://api.github.com/users/octocat/orgs",
                                                                                                                "repos_url": "https://api.github.com/users/octocat/repos",
                                                                                                                "events_url": "https://api.github.com/users/octocat/events{/privacy}",
                                                                                                                "received_events_url": "https://api.github.com/users/octocat/received_events",
                                                                                                                "type": "User",
                                                                                                                "site_admin": false
                                                                                                              },
                                                                                                              "body": "Here is the body for the review.",
                                                                                                              "commit_id": "ecdd80bb57125d7ba9641ffaa4d7d2c19d3f3091",
                                                                                                              "state": "APPROVED",
                                                                                                              "html_url": "https://github.com/octocat/Hello-World/pull/12#pullrequestreview-80",
                                                                                                              "pull_request_url": "https://api.github.com/repos/octocat/Hello-World/pulls/12",
                                                                                                              "_links": {
                                                                                                                "html": {
                                                                                                                  "href": "https://github.com/octocat/Hello-World/pull/12#pullrequestreview-80"
                                                                                                                },
                                                                                                                "pull_request": {
                                                                                                                  "href": "https://api.github.com/repos/octocat/Hello-World/pulls/12"
                                                                                                                }
                                                                                                              }
                                                                                                            }
                                                                                                          ]
                                                                                                          

                                                                                                          Get a single review

                                                                                                          GET /repos/:owner/:repo/pulls/:number/reviews/:id
                                                                                                          

                                                                                                          Response

                                                                                                          Status: 200 OK
                                                                                                          
                                                                                                          {
                                                                                                            "id": 80,
                                                                                                            "user": {
                                                                                                              "login": "octocat",
                                                                                                              "id": 1,
                                                                                                              "avatar_url": "https://github.com/images/error/octocat_happy.gif",
                                                                                                              "gravatar_id": "",
                                                                                                              "url": "https://api.github.com/users/octocat",
                                                                                                              "html_url": "https://github.com/octocat",
                                                                                                              "followers_url": "https://api.github.com/users/octocat/followers",
                                                                                                              "following_url": "https://api.github.com/users/octocat/following{/other_user}",
                                                                                                              "gists_url": "https://api.github.com/users/octocat/gists{/gist_id}",
                                                                                                              "starred_url": "https://api.github.com/users/octocat/starred{/owner}{/repo}",
                                                                                                              "subscriptions_url": "https://api.github.com/users/octocat/subscriptions",
                                                                                                              "organizations_url": "https://api.github.com/users/octocat/orgs",
                                                                                                              "repos_url": "https://api.github.com/users/octocat/repos",
                                                                                                              "events_url": "https://api.github.com/users/octocat/events{/privacy}",
                                                                                                              "received_events_url": "https://api.github.com/users/octocat/received_events",
                                                                                                              "type": "User",
                                                                                                              "site_admin": false
                                                                                                            },
                                                                                                            "body": "Here is the body for the review.",
                                                                                                            "commit_id": "ecdd80bb57125d7ba9641ffaa4d7d2c19d3f3091",
                                                                                                            "state": "APPROVED",
                                                                                                            "html_url": "https://github.com/octocat/Hello-World/pull/12#pullrequestreview-80",
                                                                                                            "pull_request_url": "https://api.github.com/repos/octocat/Hello-World/pulls/12",
                                                                                                            "_links": {
                                                                                                              "html": {
                                                                                                                "href": "https://github.com/octocat/Hello-World/pull/12#pullrequestreview-80"
                                                                                                              },
                                                                                                              "pull_request": {
                                                                                                                "href": "https://api.github.com/repos/octocat/Hello-World/pulls/12"
                                                                                                              }
                                                                                                            }
                                                                                                          }
                                                                                                          

                                                                                                          Delete a pending review

                                                                                                          DELETE /repos/:owner/:repo/pulls/:number/reviews/:id
                                                                                                          

                                                                                                          Response

                                                                                                          Status: 200 OK
                                                                                                          
                                                                                                          {
                                                                                                            "id": 80,
                                                                                                            "user": {
                                                                                                              "login": "octocat",
                                                                                                              "id": 1,
                                                                                                              "avatar_url": "https://github.com/images/error/octocat_happy.gif",
                                                                                                              "gravatar_id": "",
                                                                                                              "url": "https://api.github.com/users/octocat",
                                                                                                              "html_url": "https://github.com/octocat",
                                                                                                              "followers_url": "https://api.github.com/users/octocat/followers",
                                                                                                              "following_url": "https://api.github.com/users/octocat/following{/other_user}",
                                                                                                              "gists_url": "https://api.github.com/users/octocat/gists{/gist_id}",
                                                                                                              "starred_url": "https://api.github.com/users/octocat/starred{/owner}{/repo}",
                                                                                                              "subscriptions_url": "https://api.github.com/users/octocat/subscriptions",
                                                                                                              "organizations_url": "https://api.github.com/users/octocat/orgs",
                                                                                                              "repos_url": "https://api.github.com/users/octocat/repos",
                                                                                                              "events_url": "https://api.github.com/users/octocat/events{/privacy}",
                                                                                                              "received_events_url": "https://api.github.com/users/octocat/received_events",
                                                                                                              "type": "User",
                                                                                                              "site_admin": false
                                                                                                            },
                                                                                                            "body": "Here is the body for the review.",
                                                                                                            "commit_id": "ecdd80bb57125d7ba9641ffaa4d7d2c19d3f3091",
                                                                                                            "state": "PENDING",
                                                                                                            "html_url": "https://github.com/octocat/Hello-World/pull/12#pullrequestreview-80",
                                                                                                            "pull_request_url": "https://api.github.com/repos/octocat/Hello-World/pulls/12",
                                                                                                            "_links": {
                                                                                                              "html": {
                                                                                                                "href": "https://github.com/octocat/Hello-World/pull/12#pullrequestreview-80"
                                                                                                              },
                                                                                                              "pull_request": {
                                                                                                                "href": "https://api.github.com/repos/octocat/Hello-World/pulls/12"
                                                                                                              }
                                                                                                            }
                                                                                                          }
                                                                                                          

                                                                                                          Get comments for a single review

                                                                                                          GET /repos/:owner/:repo/pulls/:number/reviews/:id/comments
                                                                                                          

                                                                                                          Response

                                                                                                          Status: 200 OK
                                                                                                          Link: <https://api.github.com/resource?page=2>; rel="next",
                                                                                                                <https://api.github.com/resource?page=5>; rel="last"
                                                                                                          
                                                                                                          [
                                                                                                            {
                                                                                                              "url": "https://api.github.com/repos/octocat/Hello-World/pulls/comments/1",
                                                                                                              "id": 10,
                                                                                                              "pull_request_review_id": 42,
                                                                                                              "diff_hunk": "@@ -16,33 +16,40 @@ public class Connection : IConnection...",
                                                                                                              "path": "file1.txt",
                                                                                                              "position": 1,
                                                                                                              "original_position": 4,
                                                                                                              "commit_id": "6dcb09b5b57875f334f61aebed695e2e4193db5e",
                                                                                                              "original_commit_id": "9c48853fa3dc5c1c3d6f1f1cd1f2743e72652840",
                                                                                                              "in_reply_to_id": 8,
                                                                                                              "user": {
                                                                                                                "login": "octocat",
                                                                                                                "id": 1,
                                                                                                                "avatar_url": "https://github.com/images/error/octocat_happy.gif",
                                                                                                                "gravatar_id": "",
                                                                                                                "url": "https://api.github.com/users/octocat",
                                                                                                                "html_url": "https://github.com/octocat",
                                                                                                                "followers_url": "https://api.github.com/users/octocat/followers",
                                                                                                                "following_url": "https://api.github.com/users/octocat/following{/other_user}",
                                                                                                                "gists_url": "https://api.github.com/users/octocat/gists{/gist_id}",
                                                                                                                "starred_url": "https://api.github.com/users/octocat/starred{/owner}{/repo}",
                                                                                                                "subscriptions_url": "https://api.github.com/users/octocat/subscriptions",
                                                                                                                "organizations_url": "https://api.github.com/users/octocat/orgs",
                                                                                                                "repos_url": "https://api.github.com/users/octocat/repos",
                                                                                                                "events_url": "https://api.github.com/users/octocat/events{/privacy}",
                                                                                                                "received_events_url": "https://api.github.com/users/octocat/received_events",
                                                                                                                "type": "User",
                                                                                                                "site_admin": false
                                                                                                              },
                                                                                                              "body": "Great stuff",
                                                                                                              "created_at": "2011-04-14T16:00:49Z",
                                                                                                              "updated_at": "2011-04-14T16:00:49Z",
                                                                                                              "html_url": "https://github.com/octocat/Hello-World/pull/1#discussion-diff-1",
                                                                                                              "pull_request_url": "https://api.github.com/repos/octocat/Hello-World/pulls/1",
                                                                                                              "_links": {
                                                                                                                "self": {
                                                                                                                  "href": "https://api.github.com/repos/octocat/Hello-World/pulls/comments/1"
                                                                                                                },
                                                                                                                "html": {
                                                                                                                  "href": "https://github.com/octocat/Hello-World/pull/1#discussion-diff-1"
                                                                                                                },
                                                                                                                "pull_request": {
                                                                                                                  "href": "https://api.github.com/repos/octocat/Hello-World/pulls/1"
                                                                                                                }
                                                                                                              }
                                                                                                            }
                                                                                                          ]
                                                                                                          

                                                                                                          Create a pull request review

                                                                                                          POST /repos/:owner/:repo/pulls/:number/reviews
                                                                                                          

                                                                                                          Input

                                                                                                          Name Type Description
                                                                                                          commit_id string The SHA of the commit that needs a review. Not using the latest commit SHA may render your review comment outdated if a subsequent commit modifies the line you specify as the position. Defaults to the most recent commit in the pull request when you do not specify a value.
                                                                                                          body string Required when using REQUEST_CHANGES or COMMENT for the event parameter. The body text of the pull request review.
                                                                                                          event string The review action you want to perform. The review actions include: APPROVE, REQUEST_CHANGES, or COMMENT. By leaving this blank, you set the review action state to PENDING, which means you will need to submit the pull request review when you are ready.
                                                                                                          comments array of draft review comment objects Use the following table to specify the location, destination, and contents of the draft review comment.

                                                                                                          When specifying draft review comments, you need to include the following values:

                                                                                                          Name Type Description
                                                                                                          path string Required. The relative path to the file that necessitates a review comment.
                                                                                                          position integer Required. The position in the diff where you want to add a review comment. Note this value is not the same as the line number in the file. For help finding the position value, read the note below.
                                                                                                          body string Required. Text of the review comment.

                                                                                                          Note: To comment on a specific line in a file, you need to first determine the position of that line in the diff. The GitHub REST API v3 offers the application/vnd.github.v3.diff media type. To see a pull request diff, add this media type to the Accept header of a call to the single pull request endpoint.

                                                                                                          The position value equals the number of lines down from the first "@@" hunk header in the file you want to add a comment. The line just below the "@@" line is position 1, the next line is position 2, and so on. The position in the diff continues to increase through lines of whitespace and additional hunks until the beginning of a new file.

                                                                                                          Example

                                                                                                          {
                                                                                                            "commit_id": "ecdd80bb57125d7ba9641ffaa4d7d2c19d3f3091",
                                                                                                            "body": "This is close to perfect! Please address the suggested inline change.",
                                                                                                            "event": "REQUEST_CHANGES",
                                                                                                            "comments": [
                                                                                                              {
                                                                                                                "path": "file.md",
                                                                                                                "position": 6,
                                                                                                                "body": "Please add more information here, and fix this typo."
                                                                                                              }
                                                                                                            ]
                                                                                                          }
                                                                                                          

                                                                                                          Response

                                                                                                          Status: 200 OK
                                                                                                          
                                                                                                          {
                                                                                                            "id": 80,
                                                                                                            "user": {
                                                                                                              "login": "octocat",
                                                                                                              "id": 1,
                                                                                                              "avatar_url": "https://github.com/images/error/octocat_happy.gif",
                                                                                                              "gravatar_id": "",
                                                                                                              "url": "https://api.github.com/users/octocat",
                                                                                                              "html_url": "https://github.com/octocat",
                                                                                                              "followers_url": "https://api.github.com/users/octocat/followers",
                                                                                                              "following_url": "https://api.github.com/users/octocat/following{/other_user}",
                                                                                                              "gists_url": "https://api.github.com/users/octocat/gists{/gist_id}",
                                                                                                              "starred_url": "https://api.github.com/users/octocat/starred{/owner}{/repo}",
                                                                                                              "subscriptions_url": "https://api.github.com/users/octocat/subscriptions",
                                                                                                              "organizations_url": "https://api.github.com/users/octocat/orgs",
                                                                                                              "repos_url": "https://api.github.com/users/octocat/repos",
                                                                                                              "events_url": "https://api.github.com/users/octocat/events{/privacy}",
                                                                                                              "received_events_url": "https://api.github.com/users/octocat/received_events",
                                                                                                              "type": "User",
                                                                                                              "site_admin": false
                                                                                                            },
                                                                                                            "body": "This is close to perfect! Please address the suggested inline change.",
                                                                                                            "commit_id": "ecdd80bb57125d7ba9641ffaa4d7d2c19d3f3091",
                                                                                                            "state": "CHANGES_REQUESTED",
                                                                                                            "html_url": "https://github.com/octocat/Hello-World/pull/12#pullrequestreview-80",
                                                                                                            "pull_request_url": "https://api.github.com/repos/octocat/Hello-World/pulls/12",
                                                                                                            "_links": {
                                                                                                              "html": {
                                                                                                                "href": "https://github.com/octocat/Hello-World/pull/12#pullrequestreview-80"
                                                                                                              },
                                                                                                              "pull_request": {
                                                                                                                "href": "https://api.github.com/repos/octocat/Hello-World/pulls/12"
                                                                                                              }
                                                                                                            }
                                                                                                          }
                                                                                                          

                                                                                                          Submit a pull request review

                                                                                                          POST /repos/:owner/:repo/pulls/:number/reviews/:id/events
                                                                                                          

                                                                                                          Input

                                                                                                          Name Type Description
                                                                                                          body string The body text of the pull request review
                                                                                                          event string Required. The review action you want to perform. The review actions include: APPROVE, REQUEST_CHANGES, or COMMENT. When you leave this blank, the API returns HTTP 422 (Unrecognizable entity) and sets the review action state to PENDING, which means you will need to re-submit the pull request review using a review action.

                                                                                                          Response

                                                                                                          Status: 200 OK
                                                                                                          
                                                                                                          {
                                                                                                            "id": 80,
                                                                                                            "user": {
                                                                                                              "login": "octocat",
                                                                                                              "id": 1,
                                                                                                              "avatar_url": "https://github.com/images/error/octocat_happy.gif",
                                                                                                              "gravatar_id": "",
                                                                                                              "url": "https://api.github.com/users/octocat",
                                                                                                              "html_url": "https://github.com/octocat",
                                                                                                              "followers_url": "https://api.github.com/users/octocat/followers",
                                                                                                              "following_url": "https://api.github.com/users/octocat/following{/other_user}",
                                                                                                              "gists_url": "https://api.github.com/users/octocat/gists{/gist_id}",
                                                                                                              "starred_url": "https://api.github.com/users/octocat/starred{/owner}{/repo}",
                                                                                                              "subscriptions_url": "https://api.github.com/users/octocat/subscriptions",
                                                                                                              "organizations_url": "https://api.github.com/users/octocat/orgs",
                                                                                                              "repos_url": "https://api.github.com/users/octocat/repos",
                                                                                                              "events_url": "https://api.github.com/users/octocat/events{/privacy}",
                                                                                                              "received_events_url": "https://api.github.com/users/octocat/received_events",
                                                                                                              "type": "User",
                                                                                                              "site_admin": false
                                                                                                            },
                                                                                                            "body": "Here is the body for the review.",
                                                                                                            "commit_id": "ecdd80bb57125d7ba9641ffaa4d7d2c19d3f3091",
                                                                                                            "state": "APPROVED",
                                                                                                            "html_url": "https://github.com/octocat/Hello-World/pull/12#pullrequestreview-80",
                                                                                                            "pull_request_url": "https://api.github.com/repos/octocat/Hello-World/pulls/12",
                                                                                                            "_links": {
                                                                                                              "html": {
                                                                                                                "href": "https://github.com/octocat/Hello-World/pull/12#pullrequestreview-80"
                                                                                                              },
                                                                                                              "pull_request": {
                                                                                                                "href": "https://api.github.com/repos/octocat/Hello-World/pulls/12"
                                                                                                              }
                                                                                                            }
                                                                                                          }
                                                                                                          

                                                                                                          Dismiss a pull request review

                                                                                                          PUT /repos/:owner/:repo/pulls/:number/reviews/:id/dismissals
                                                                                                          

                                                                                                          Note: To dismiss a pull request review on a protected branch, you must be a repository administrator or be included in the list of people or teams who can dismiss pull request reviews.

                                                                                                          Input

                                                                                                          Name Type Description
                                                                                                          message string Required. The message for the pull request review dismissal

                                                                                                          Response

                                                                                                          Status: 200 OK
                                                                                                          
                                                                                                          {
                                                                                                            "id": 80,
                                                                                                            "user": {
                                                                                                              "login": "octocat",
                                                                                                              "id": 1,
                                                                                                              "avatar_url": "https://github.com/images/error/octocat_happy.gif",
                                                                                                              "gravatar_id": "",
                                                                                                              "url": "https://api.github.com/users/octocat",
                                                                                                              "html_url": "https://github.com/octocat",
                                                                                                              "followers_url": "https://api.github.com/users/octocat/followers",
                                                                                                              "following_url": "https://api.github.com/users/octocat/following{/other_user}",
                                                                                                              "gists_url": "https://api.github.com/users/octocat/gists{/gist_id}",
                                                                                                              "starred_url": "https://api.github.com/users/octocat/starred{/owner}{/repo}",
                                                                                                              "subscriptions_url": "https://api.github.com/users/octocat/subscriptions",
                                                                                                              "organizations_url": "https://api.github.com/users/octocat/orgs",
                                                                                                              "repos_url": "https://api.github.com/users/octocat/repos",
                                                                                                              "events_url": "https://api.github.com/users/octocat/events{/privacy}",
                                                                                                              "received_events_url": "https://api.github.com/users/octocat/received_events",
                                                                                                              "type": "User",
                                                                                                              "site_admin": false
                                                                                                            },
                                                                                                            "body": "Here is the body for the review.",
                                                                                                            "commit_id": "ecdd80bb57125d7ba9641ffaa4d7d2c19d3f3091",
                                                                                                            "state": "DISMISSED",
                                                                                                            "html_url": "https://github.com/octocat/Hello-World/pull/12#pullrequestreview-80",
                                                                                                            "pull_request_url": "https://api.github.com/repos/octocat/Hello-World/pulls/12",
                                                                                                            "_links": {
                                                                                                              "html": {
                                                                                                                "href": "https://github.com/octocat/Hello-World/pull/12#pullrequestreview-80"
                                                                                                              },
                                                                                                              "pull_request": {
                                                                                                                "href": "https://api.github.com/repos/octocat/Hello-World/pulls/12"
                                                                                                              }
                                                                                                            }
                                                                                                          }
                                                                                                          
                                                                                                          tmp/developer.github.com/v3/rate_limit/index.html Rate Limit | GitHub Developer Guide

                                                                                                          Rate Limit

                                                                                                          The overview documentation describes the rate limit rules. You can check your current rate limit status at any time using the Rate Limit API described below.

                                                                                                          Get your current rate limit status

                                                                                                          Note: Accessing this endpoint does not count against your rate limit.

                                                                                                          GET /rate_limit
                                                                                                          

                                                                                                          Response

                                                                                                          Status: 200 OK
                                                                                                          X-RateLimit-Limit: 5000
                                                                                                          X-RateLimit-Remaining: 4999
                                                                                                          X-RateLimit-Reset: 1372700873
                                                                                                          
                                                                                                          {
                                                                                                            "resources": {
                                                                                                              "core": {
                                                                                                                "limit": 5000,
                                                                                                                "remaining": 4999,
                                                                                                                "reset": 1372700873
                                                                                                              },
                                                                                                              "search": {
                                                                                                                "limit": 30,
                                                                                                                "remaining": 18,
                                                                                                                "reset": 1372697452
                                                                                                              }
                                                                                                            },
                                                                                                            "rate": {
                                                                                                              "limit": 5000,
                                                                                                              "remaining": 4999,
                                                                                                              "reset": 1372700873
                                                                                                            }
                                                                                                          }
                                                                                                          


                                                                                                          Understanding Your Rate Limit Status

                                                                                                          The Search API has a custom rate limit, separate from the rate limit governing the rest of the API. For that reason, the response (shown above) categorizes your rate limit by resource. Within the "resources" object, the "search" object provides your rate limit status for the Search API. The "core" object provides your rate limit status for all the rest of the API.

                                                                                                          Deprecation Notice

                                                                                                          The "rate" object (shown at the bottom of the response above) is deprecated.

                                                                                                          If you're writing new API client code (or updating your existing code), you should use the "core" object instead of the "rate" object. The "core" object contains the same information that is present in the "rate" object.

                                                                                                          tmp/developer.github.com/v3/reactions/index.html Reactions | GitHub Developer Guide

                                                                                                          Reactions

                                                                                                          Note: APIs for managing reactions are currently available for developers to preview. See the blog post for full details. To access the API during the preview period, you must provide a custom media type in the Accept header:

                                                                                                            application/vnd.github.squirrel-girl-preview+json
                                                                                                          

                                                                                                          Note: To help with migrating from our REST API v3 to GraphQL API v4, we're introducing a preview period to include the GraphQL node_id in the response for many REST API v3 resources. See the blog post for full details. To access node_id during the preview period, you must provide a custom media type in the Accept header:

                                                                                                          application/vnd.github.jean-grey-preview+json
                                                                                                          

                                                                                                          Warning: The API may change without advance notice during the preview period. Preview features are not supported for production use. If you experience any issues, contact GitHub support.

                                                                                                          Reaction types

                                                                                                          When creating a reaction, the allowed values for the content parameter are as follows (with the corresponding emoji for reference):

                                                                                                          content emoji
                                                                                                          +1 :+1:
                                                                                                          -1 :-1:
                                                                                                          laugh :smile:
                                                                                                          confused :confused:
                                                                                                          heart :heart:
                                                                                                          hooray :tada:

                                                                                                          List reactions for a commit comment

                                                                                                          GET /repos/:owner/:repo/comments/:id/reactions
                                                                                                          

                                                                                                          Parameters

                                                                                                          Name Type Description
                                                                                                          content string Indicates which type of reaction to return.

                                                                                                          Response

                                                                                                          Status: 200 OK
                                                                                                          Link: <https://api.github.com/resource?page=2>; rel="next",
                                                                                                                <https://api.github.com/resource?page=5>; rel="last"
                                                                                                          
                                                                                                          [
                                                                                                            {
                                                                                                              "id": 1,
                                                                                                              "user": {
                                                                                                                "login": "octocat",
                                                                                                                "id": 1,
                                                                                                                "avatar_url": "https://github.com/images/error/octocat_happy.gif",
                                                                                                                "gravatar_id": "",
                                                                                                                "url": "https://api.github.com/users/octocat",
                                                                                                                "html_url": "https://github.com/octocat",
                                                                                                                "followers_url": "https://api.github.com/users/octocat/followers",
                                                                                                                "following_url": "https://api.github.com/users/octocat/following{/other_user}",
                                                                                                                "gists_url": "https://api.github.com/users/octocat/gists{/gist_id}",
                                                                                                                "starred_url": "https://api.github.com/users/octocat/starred{/owner}{/repo}",
                                                                                                                "subscriptions_url": "https://api.github.com/users/octocat/subscriptions",
                                                                                                                "organizations_url": "https://api.github.com/users/octocat/orgs",
                                                                                                                "repos_url": "https://api.github.com/users/octocat/repos",
                                                                                                                "events_url": "https://api.github.com/users/octocat/events{/privacy}",
                                                                                                                "received_events_url": "https://api.github.com/users/octocat/received_events",
                                                                                                                "type": "User",
                                                                                                                "site_admin": false
                                                                                                              },
                                                                                                              "content": "heart",
                                                                                                              "created_at": "2016-05-20T20:09:31Z"
                                                                                                            }
                                                                                                          ]
                                                                                                          

                                                                                                          Create reaction for a commit comment

                                                                                                          POST /repos/:owner/:repo/comments/:id/reactions
                                                                                                          

                                                                                                          Parameters

                                                                                                          Name Type Description
                                                                                                          content string Required. The reaction type
                                                                                                          {
                                                                                                            "content": "heart"
                                                                                                          }
                                                                                                          

                                                                                                          Response

                                                                                                          If you have already created a reaction of type content, the previously created reaction will be returned with Status: 200 OK.

                                                                                                          Status: 201 Created
                                                                                                          
                                                                                                          {
                                                                                                            "id": 1,
                                                                                                            "user": {
                                                                                                              "login": "octocat",
                                                                                                              "id": 1,
                                                                                                              "avatar_url": "https://github.com/images/error/octocat_happy.gif",
                                                                                                              "gravatar_id": "",
                                                                                                              "url": "https://api.github.com/users/octocat",
                                                                                                              "html_url": "https://github.com/octocat",
                                                                                                              "followers_url": "https://api.github.com/users/octocat/followers",
                                                                                                              "following_url": "https://api.github.com/users/octocat/following{/other_user}",
                                                                                                              "gists_url": "https://api.github.com/users/octocat/gists{/gist_id}",
                                                                                                              "starred_url": "https://api.github.com/users/octocat/starred{/owner}{/repo}",
                                                                                                              "subscriptions_url": "https://api.github.com/users/octocat/subscriptions",
                                                                                                              "organizations_url": "https://api.github.com/users/octocat/orgs",
                                                                                                              "repos_url": "https://api.github.com/users/octocat/repos",
                                                                                                              "events_url": "https://api.github.com/users/octocat/events{/privacy}",
                                                                                                              "received_events_url": "https://api.github.com/users/octocat/received_events",
                                                                                                              "type": "User",
                                                                                                              "site_admin": false
                                                                                                            },
                                                                                                            "content": "heart",
                                                                                                            "created_at": "2016-05-20T20:09:31Z"
                                                                                                          }
                                                                                                          

                                                                                                          List reactions for an issue

                                                                                                          GET /repos/:owner/:repo/issues/:number/reactions
                                                                                                          

                                                                                                          Parameters

                                                                                                          Name Type Description
                                                                                                          content string Indicates which type of reaction to return.

                                                                                                          Response

                                                                                                          Status: 200 OK
                                                                                                          Link: <https://api.github.com/resource?page=2>; rel="next",
                                                                                                                <https://api.github.com/resource?page=5>; rel="last"
                                                                                                          
                                                                                                          [
                                                                                                            {
                                                                                                              "id": 1,
                                                                                                              "user": {
                                                                                                                "login": "octocat",
                                                                                                                "id": 1,
                                                                                                                "avatar_url": "https://github.com/images/error/octocat_happy.gif",
                                                                                                                "gravatar_id": "",
                                                                                                                "url": "https://api.github.com/users/octocat",
                                                                                                                "html_url": "https://github.com/octocat",
                                                                                                                "followers_url": "https://api.github.com/users/octocat/followers",
                                                                                                                "following_url": "https://api.github.com/users/octocat/following{/other_user}",
                                                                                                                "gists_url": "https://api.github.com/users/octocat/gists{/gist_id}",
                                                                                                                "starred_url": "https://api.github.com/users/octocat/starred{/owner}{/repo}",
                                                                                                                "subscriptions_url": "https://api.github.com/users/octocat/subscriptions",
                                                                                                                "organizations_url": "https://api.github.com/users/octocat/orgs",
                                                                                                                "repos_url": "https://api.github.com/users/octocat/repos",
                                                                                                                "events_url": "https://api.github.com/users/octocat/events{/privacy}",
                                                                                                                "received_events_url": "https://api.github.com/users/octocat/received_events",
                                                                                                                "type": "User",
                                                                                                                "site_admin": false
                                                                                                              },
                                                                                                              "content": "heart",
                                                                                                              "created_at": "2016-05-20T20:09:31Z"
                                                                                                            }
                                                                                                          ]
                                                                                                          

                                                                                                          Create reaction for an issue

                                                                                                          POST /repos/:owner/:repo/issues/:number/reactions
                                                                                                          

                                                                                                          Parameters

                                                                                                          Name Type Description
                                                                                                          content string Required. The reaction type
                                                                                                          {
                                                                                                            "content": "heart"
                                                                                                          }
                                                                                                          

                                                                                                          Response

                                                                                                          If you have already created a reaction of type content, the previously created reaction will be returned with Status: 200 OK.

                                                                                                          Status: 201 Created
                                                                                                          
                                                                                                          {
                                                                                                            "id": 1,
                                                                                                            "user": {
                                                                                                              "login": "octocat",
                                                                                                              "id": 1,
                                                                                                              "avatar_url": "https://github.com/images/error/octocat_happy.gif",
                                                                                                              "gravatar_id": "",
                                                                                                              "url": "https://api.github.com/users/octocat",
                                                                                                              "html_url": "https://github.com/octocat",
                                                                                                              "followers_url": "https://api.github.com/users/octocat/followers",
                                                                                                              "following_url": "https://api.github.com/users/octocat/following{/other_user}",
                                                                                                              "gists_url": "https://api.github.com/users/octocat/gists{/gist_id}",
                                                                                                              "starred_url": "https://api.github.com/users/octocat/starred{/owner}{/repo}",
                                                                                                              "subscriptions_url": "https://api.github.com/users/octocat/subscriptions",
                                                                                                              "organizations_url": "https://api.github.com/users/octocat/orgs",
                                                                                                              "repos_url": "https://api.github.com/users/octocat/repos",
                                                                                                              "events_url": "https://api.github.com/users/octocat/events{/privacy}",
                                                                                                              "received_events_url": "https://api.github.com/users/octocat/received_events",
                                                                                                              "type": "User",
                                                                                                              "site_admin": false
                                                                                                            },
                                                                                                            "content": "heart",
                                                                                                            "created_at": "2016-05-20T20:09:31Z"
                                                                                                          }
                                                                                                          

                                                                                                          List reactions for an issue comment

                                                                                                          GET /repos/:owner/:repo/issues/comments/:id/reactions
                                                                                                          

                                                                                                          Parameters

                                                                                                          Name Type Description
                                                                                                          content string Indicates which type of reaction to return.

                                                                                                          Response

                                                                                                          Status: 200 OK
                                                                                                          Link: <https://api.github.com/resource?page=2>; rel="next",
                                                                                                                <https://api.github.com/resource?page=5>; rel="last"
                                                                                                          
                                                                                                          [
                                                                                                            {
                                                                                                              "id": 1,
                                                                                                              "user": {
                                                                                                                "login": "octocat",
                                                                                                                "id": 1,
                                                                                                                "avatar_url": "https://github.com/images/error/octocat_happy.gif",
                                                                                                                "gravatar_id": "",
                                                                                                                "url": "https://api.github.com/users/octocat",
                                                                                                                "html_url": "https://github.com/octocat",
                                                                                                                "followers_url": "https://api.github.com/users/octocat/followers",
                                                                                                                "following_url": "https://api.github.com/users/octocat/following{/other_user}",
                                                                                                                "gists_url": "https://api.github.com/users/octocat/gists{/gist_id}",
                                                                                                                "starred_url": "https://api.github.com/users/octocat/starred{/owner}{/repo}",
                                                                                                                "subscriptions_url": "https://api.github.com/users/octocat/subscriptions",
                                                                                                                "organizations_url": "https://api.github.com/users/octocat/orgs",
                                                                                                                "repos_url": "https://api.github.com/users/octocat/repos",
                                                                                                                "events_url": "https://api.github.com/users/octocat/events{/privacy}",
                                                                                                                "received_events_url": "https://api.github.com/users/octocat/received_events",
                                                                                                                "type": "User",
                                                                                                                "site_admin": false
                                                                                                              },
                                                                                                              "content": "heart",
                                                                                                              "created_at": "2016-05-20T20:09:31Z"
                                                                                                            }
                                                                                                          ]
                                                                                                          

                                                                                                          Create reaction for an issue comment

                                                                                                          POST /repos/:owner/:repo/issues/comments/:id/reactions
                                                                                                          

                                                                                                          Parameters

                                                                                                          Name Type Description
                                                                                                          content string Required. The reaction type
                                                                                                          {
                                                                                                            "content": "heart"
                                                                                                          }
                                                                                                          

                                                                                                          Response

                                                                                                          If you have already created a reaction of type content, the previously created reaction will be returned with Status: 200 OK.

                                                                                                          Status: 201 Created
                                                                                                          
                                                                                                          {
                                                                                                            "id": 1,
                                                                                                            "user": {
                                                                                                              "login": "octocat",
                                                                                                              "id": 1,
                                                                                                              "avatar_url": "https://github.com/images/error/octocat_happy.gif",
                                                                                                              "gravatar_id": "",
                                                                                                              "url": "https://api.github.com/users/octocat",
                                                                                                              "html_url": "https://github.com/octocat",
                                                                                                              "followers_url": "https://api.github.com/users/octocat/followers",
                                                                                                              "following_url": "https://api.github.com/users/octocat/following{/other_user}",
                                                                                                              "gists_url": "https://api.github.com/users/octocat/gists{/gist_id}",
                                                                                                              "starred_url": "https://api.github.com/users/octocat/starred{/owner}{/repo}",
                                                                                                              "subscriptions_url": "https://api.github.com/users/octocat/subscriptions",
                                                                                                              "organizations_url": "https://api.github.com/users/octocat/orgs",
                                                                                                              "repos_url": "https://api.github.com/users/octocat/repos",
                                                                                                              "events_url": "https://api.github.com/users/octocat/events{/privacy}",
                                                                                                              "received_events_url": "https://api.github.com/users/octocat/received_events",
                                                                                                              "type": "User",
                                                                                                              "site_admin": false
                                                                                                            },
                                                                                                            "content": "heart",
                                                                                                            "created_at": "2016-05-20T20:09:31Z"
                                                                                                          }
                                                                                                          

                                                                                                          List reactions for a pull request review comment

                                                                                                          GET /repos/:owner/:repo/pulls/comments/:id/reactions
                                                                                                          

                                                                                                          Parameters

                                                                                                          Name Type Description
                                                                                                          content string Indicates which type of reaction to return.

                                                                                                          Response

                                                                                                          Status: 200 OK
                                                                                                          Link: <https://api.github.com/resource?page=2>; rel="next",
                                                                                                                <https://api.github.com/resource?page=5>; rel="last"
                                                                                                          
                                                                                                          [
                                                                                                            {
                                                                                                              "id": 1,
                                                                                                              "user": {
                                                                                                                "login": "octocat",
                                                                                                                "id": 1,
                                                                                                                "avatar_url": "https://github.com/images/error/octocat_happy.gif",
                                                                                                                "gravatar_id": "",
                                                                                                                "url": "https://api.github.com/users/octocat",
                                                                                                                "html_url": "https://github.com/octocat",
                                                                                                                "followers_url": "https://api.github.com/users/octocat/followers",
                                                                                                                "following_url": "https://api.github.com/users/octocat/following{/other_user}",
                                                                                                                "gists_url": "https://api.github.com/users/octocat/gists{/gist_id}",
                                                                                                                "starred_url": "https://api.github.com/users/octocat/starred{/owner}{/repo}",
                                                                                                                "subscriptions_url": "https://api.github.com/users/octocat/subscriptions",
                                                                                                                "organizations_url": "https://api.github.com/users/octocat/orgs",
                                                                                                                "repos_url": "https://api.github.com/users/octocat/repos",
                                                                                                                "events_url": "https://api.github.com/users/octocat/events{/privacy}",
                                                                                                                "received_events_url": "https://api.github.com/users/octocat/received_events",
                                                                                                                "type": "User",
                                                                                                                "site_admin": false
                                                                                                              },
                                                                                                              "content": "heart",
                                                                                                              "created_at": "2016-05-20T20:09:31Z"
                                                                                                            }
                                                                                                          ]
                                                                                                          

                                                                                                          Create reaction for a pull request review comment

                                                                                                          POST /repos/:owner/:repo/pulls/comments/:id/reactions
                                                                                                          

                                                                                                          Parameters

                                                                                                          Name Type Description
                                                                                                          content string Required. The reaction type
                                                                                                          {
                                                                                                            "content": "heart"
                                                                                                          }
                                                                                                          

                                                                                                          Response

                                                                                                          If you have already created a reaction of type content, the previously created reaction will be returned with Status: 200 OK.

                                                                                                          Status: 201 Created
                                                                                                          
                                                                                                          {
                                                                                                            "id": 1,
                                                                                                            "user": {
                                                                                                              "login": "octocat",
                                                                                                              "id": 1,
                                                                                                              "avatar_url": "https://github.com/images/error/octocat_happy.gif",
                                                                                                              "gravatar_id": "",
                                                                                                              "url": "https://api.github.com/users/octocat",
                                                                                                              "html_url": "https://github.com/octocat",
                                                                                                              "followers_url": "https://api.github.com/users/octocat/followers",
                                                                                                              "following_url": "https://api.github.com/users/octocat/following{/other_user}",
                                                                                                              "gists_url": "https://api.github.com/users/octocat/gists{/gist_id}",
                                                                                                              "starred_url": "https://api.github.com/users/octocat/starred{/owner}{/repo}",
                                                                                                              "subscriptions_url": "https://api.github.com/users/octocat/subscriptions",
                                                                                                              "organizations_url": "https://api.github.com/users/octocat/orgs",
                                                                                                              "repos_url": "https://api.github.com/users/octocat/repos",
                                                                                                              "events_url": "https://api.github.com/users/octocat/events{/privacy}",
                                                                                                              "received_events_url": "https://api.github.com/users/octocat/received_events",
                                                                                                              "type": "User",
                                                                                                              "site_admin": false
                                                                                                            },
                                                                                                            "content": "heart",
                                                                                                            "created_at": "2016-05-20T20:09:31Z"
                                                                                                          }
                                                                                                          

                                                                                                          Delete a reaction

                                                                                                          DELETE /reactions/:id
                                                                                                          

                                                                                                          Response

                                                                                                          Status: 204 No Content
                                                                                                          
                                                                                                          tmp/developer.github.com/v3/repos/index.html Repositories | GitHub Developer Guide

                                                                                                          Repositories

                                                                                                          Note: The topics property for repositories on GitHub is currently available for developers to preview. To view the topics property in calls that return repository results, you must provide a custom media type in the Accept header:

                                                                                                          application/vnd.github.mercy-preview+json
                                                                                                          

                                                                                                          Note: The Repository Transfer API is currently available for developers to preview. To access the API, you must provide a custom media type in the Accept header:

                                                                                                          application/vnd.github.nightshade-preview+json
                                                                                                          

                                                                                                          Note: To help with migrating from our REST API v3 to GraphQL API v4, we're introducing a preview period to include the GraphQL node_id in the response for many REST API v3 resources. See the blog post for full details. To access node_id during the preview period, you must provide a custom media type in the Accept header:

                                                                                                          application/vnd.github.jean-grey-preview+json
                                                                                                          

                                                                                                          Warning: The API may change without advance notice during the preview period. Preview features are not supported for production use. If you experience any issues, contact GitHub support.

                                                                                                          List your repositories

                                                                                                          List repositories that are accessible to the authenticated user.

                                                                                                          This includes repositories owned by the authenticated user, repositories where the authenticated user is a collaborator, and repositories that the authenticated user has access to through an organization membership.

                                                                                                          GET /user/repos
                                                                                                          

                                                                                                          Parameters

                                                                                                          Name Type Description
                                                                                                          visibility string Can be one of all, public, or private. Default: all
                                                                                                          affiliation string Comma-separated list of values. Can include:
                                                                                                          * owner: Repositories that are owned by the authenticated user.
                                                                                                          * collaborator: Repositories that the user has been added to as a collaborator.
                                                                                                          * organization_member: Repositories that the user has access to through being a member of an organization. This includes every repository on every team that the user is on.

                                                                                                          Default: owner,collaborator,organization_member
                                                                                                          type string Can be one of all, owner, public, private, member. Default: all

                                                                                                          Will cause a 422 error if used in the same request as visibility or affiliation.
                                                                                                          sort string Can be one of created, updated, pushed, full_name. Default: full_name
                                                                                                          direction string Can be one of asc or desc. Default: when using full_name: asc; otherwise desc

                                                                                                          List user repositories

                                                                                                          List public repositories for the specified user.

                                                                                                          GET /users/:username/repos
                                                                                                          

                                                                                                          Parameters

                                                                                                          Name Type Description
                                                                                                          type string Can be one of all, owner, member. Default: owner
                                                                                                          sort string Can be one of created, updated, pushed, full_name. Default: full_name
                                                                                                          direction string Can be one of asc or desc. Default: when using full_name: asc, otherwise desc

                                                                                                          List organization repositories

                                                                                                          List repositories for the specified org.

                                                                                                          GET /orgs/:org/repos
                                                                                                          

                                                                                                          Parameters

                                                                                                          Name Type Description
                                                                                                          type string Can be one of all, public, private, forks, sources, member. Default: all

                                                                                                          Response

                                                                                                          Status: 200 OK
                                                                                                          Link: <https://api.github.com/resource?page=2>; rel="next",
                                                                                                                <https://api.github.com/resource?page=5>; rel="last"
                                                                                                          
                                                                                                          [
                                                                                                            {
                                                                                                              "id": 1296269,
                                                                                                              "owner": {
                                                                                                                "login": "octocat",
                                                                                                                "id": 1,
                                                                                                                "avatar_url": "https://github.com/images/error/octocat_happy.gif",
                                                                                                                "gravatar_id": "",
                                                                                                                "url": "https://api.github.com/users/octocat",
                                                                                                                "html_url": "https://github.com/octocat",
                                                                                                                "followers_url": "https://api.github.com/users/octocat/followers",
                                                                                                                "following_url": "https://api.github.com/users/octocat/following{/other_user}",
                                                                                                                "gists_url": "https://api.github.com/users/octocat/gists{/gist_id}",
                                                                                                                "starred_url": "https://api.github.com/users/octocat/starred{/owner}{/repo}",
                                                                                                                "subscriptions_url": "https://api.github.com/users/octocat/subscriptions",
                                                                                                                "organizations_url": "https://api.github.com/users/octocat/orgs",
                                                                                                                "repos_url": "https://api.github.com/users/octocat/repos",
                                                                                                                "events_url": "https://api.github.com/users/octocat/events{/privacy}",
                                                                                                                "received_events_url": "https://api.github.com/users/octocat/received_events",
                                                                                                                "type": "User",
                                                                                                                "site_admin": false
                                                                                                              },
                                                                                                              "name": "Hello-World",
                                                                                                              "full_name": "octocat/Hello-World",
                                                                                                              "description": "This your first repo!",
                                                                                                              "private": false,
                                                                                                              "fork": false,
                                                                                                              "url": "https://api.github.com/repos/octocat/Hello-World",
                                                                                                              "html_url": "https://github.com/octocat/Hello-World",
                                                                                                              "archive_url": "http://api.github.com/repos/octocat/Hello-World/{archive_format}{/ref}",
                                                                                                              "assignees_url": "http://api.github.com/repos/octocat/Hello-World/assignees{/user}",
                                                                                                              "blobs_url": "http://api.github.com/repos/octocat/Hello-World/git/blobs{/sha}",
                                                                                                              "branches_url": "http://api.github.com/repos/octocat/Hello-World/branches{/branch}",
                                                                                                              "clone_url": "https://github.com/octocat/Hello-World.git",
                                                                                                              "collaborators_url": "http://api.github.com/repos/octocat/Hello-World/collaborators{/collaborator}",
                                                                                                              "comments_url": "http://api.github.com/repos/octocat/Hello-World/comments{/number}",
                                                                                                              "commits_url": "http://api.github.com/repos/octocat/Hello-World/commits{/sha}",
                                                                                                              "compare_url": "http://api.github.com/repos/octocat/Hello-World/compare/{base}...{head}",
                                                                                                              "contents_url": "http://api.github.com/repos/octocat/Hello-World/contents/{+path}",
                                                                                                              "contributors_url": "http://api.github.com/repos/octocat/Hello-World/contributors",
                                                                                                              "deployments_url": "http://api.github.com/repos/octocat/Hello-World/deployments",
                                                                                                              "downloads_url": "http://api.github.com/repos/octocat/Hello-World/downloads",
                                                                                                              "events_url": "http://api.github.com/repos/octocat/Hello-World/events",
                                                                                                              "forks_url": "http://api.github.com/repos/octocat/Hello-World/forks",
                                                                                                              "git_commits_url": "http://api.github.com/repos/octocat/Hello-World/git/commits{/sha}",
                                                                                                              "git_refs_url": "http://api.github.com/repos/octocat/Hello-World/git/refs{/sha}",
                                                                                                              "git_tags_url": "http://api.github.com/repos/octocat/Hello-World/git/tags{/sha}",
                                                                                                              "git_url": "git:github.com/octocat/Hello-World.git",
                                                                                                              "hooks_url": "http://api.github.com/repos/octocat/Hello-World/hooks",
                                                                                                              "issue_comment_url": "http://api.github.com/repos/octocat/Hello-World/issues/comments{/number}",
                                                                                                              "issue_events_url": "http://api.github.com/repos/octocat/Hello-World/issues/events{/number}",
                                                                                                              "issues_url": "http://api.github.com/repos/octocat/Hello-World/issues{/number}",
                                                                                                              "keys_url": "http://api.github.com/repos/octocat/Hello-World/keys{/key_id}",
                                                                                                              "labels_url": "http://api.github.com/repos/octocat/Hello-World/labels{/name}",
                                                                                                              "languages_url": "http://api.github.com/repos/octocat/Hello-World/languages",
                                                                                                              "merges_url": "http://api.github.com/repos/octocat/Hello-World/merges",
                                                                                                              "milestones_url": "http://api.github.com/repos/octocat/Hello-World/milestones{/number}",
                                                                                                              "mirror_url": "git:git.example.com/octocat/Hello-World",
                                                                                                              "notifications_url": "http://api.github.com/repos/octocat/Hello-World/notifications{?since,all,participating}",
                                                                                                              "pulls_url": "http://api.github.com/repos/octocat/Hello-World/pulls{/number}",
                                                                                                              "releases_url": "http://api.github.com/repos/octocat/Hello-World/releases{/id}",
                                                                                                              "ssh_url": "git@github.com:octocat/Hello-World.git",
                                                                                                              "stargazers_url": "http://api.github.com/repos/octocat/Hello-World/stargazers",
                                                                                                              "statuses_url": "http://api.github.com/repos/octocat/Hello-World/statuses/{sha}",
                                                                                                              "subscribers_url": "http://api.github.com/repos/octocat/Hello-World/subscribers",
                                                                                                              "subscription_url": "http://api.github.com/repos/octocat/Hello-World/subscription",
                                                                                                              "svn_url": "https://svn.github.com/octocat/Hello-World",
                                                                                                              "tags_url": "http://api.github.com/repos/octocat/Hello-World/tags",
                                                                                                              "teams_url": "http://api.github.com/repos/octocat/Hello-World/teams",
                                                                                                              "trees_url": "http://api.github.com/repos/octocat/Hello-World/git/trees{/sha}",
                                                                                                              "homepage": "https://github.com",
                                                                                                              "language": null,
                                                                                                              "forks_count": 9,
                                                                                                              "stargazers_count": 80,
                                                                                                              "watchers_count": 80,
                                                                                                              "size": 108,
                                                                                                              "default_branch": "master",
                                                                                                              "open_issues_count": 0,
                                                                                                              "topics": [
                                                                                                                "octocat",
                                                                                                                "atom",
                                                                                                                "electron",
                                                                                                                "API"
                                                                                                              ],
                                                                                                              "has_issues": true,
                                                                                                              "has_wiki": true,
                                                                                                              "has_pages": false,
                                                                                                              "has_downloads": true,
                                                                                                              "archived": false,
                                                                                                              "pushed_at": "2011-01-26T19:06:43Z",
                                                                                                              "created_at": "2011-01-26T19:01:12Z",
                                                                                                              "updated_at": "2011-01-26T19:14:43Z",
                                                                                                              "permissions": {
                                                                                                                "admin": false,
                                                                                                                "push": false,
                                                                                                                "pull": true
                                                                                                              },
                                                                                                              "allow_rebase_merge": true,
                                                                                                              "allow_squash_merge": true,
                                                                                                              "allow_merge_commit": true,
                                                                                                              "subscribers_count": 42,
                                                                                                              "network_count": 0,
                                                                                                              "license": {
                                                                                                                "key": "mit",
                                                                                                                "name": "MIT License",
                                                                                                                "spdx_id": "MIT",
                                                                                                                "url": "https://api.github.com/licenses/mit",
                                                                                                                "html_url": "http://choosealicense.com/licenses/mit/"
                                                                                                              }
                                                                                                            }
                                                                                                          ]
                                                                                                          

                                                                                                          List all public repositories

                                                                                                          This provides a dump of every public repository, in the order that they were created.

                                                                                                          Note: Pagination is powered exclusively by the since parameter. Use the Link header to get the URL for the next page of repositories.

                                                                                                          GET /repositories
                                                                                                          

                                                                                                          Parameters

                                                                                                          Name Type Description
                                                                                                          since string The integer ID of the last Repository that you've seen.

                                                                                                          Response

                                                                                                          Status: 200 OK
                                                                                                          Link: <https://api.github.com/repositories?since=364>; rel="next"
                                                                                                          
                                                                                                          [
                                                                                                            {
                                                                                                              "id": 1296269,
                                                                                                              "owner": {
                                                                                                                "login": "octocat",
                                                                                                                "id": 1,
                                                                                                                "avatar_url": "https://github.com/images/error/octocat_happy.gif",
                                                                                                                "gravatar_id": "",
                                                                                                                "url": "https://api.github.com/users/octocat",
                                                                                                                "html_url": "https://github.com/octocat",
                                                                                                                "followers_url": "https://api.github.com/users/octocat/followers",
                                                                                                                "following_url": "https://api.github.com/users/octocat/following{/other_user}",
                                                                                                                "gists_url": "https://api.github.com/users/octocat/gists{/gist_id}",
                                                                                                                "starred_url": "https://api.github.com/users/octocat/starred{/owner}{/repo}",
                                                                                                                "subscriptions_url": "https://api.github.com/users/octocat/subscriptions",
                                                                                                                "organizations_url": "https://api.github.com/users/octocat/orgs",
                                                                                                                "repos_url": "https://api.github.com/users/octocat/repos",
                                                                                                                "events_url": "https://api.github.com/users/octocat/events{/privacy}",
                                                                                                                "received_events_url": "https://api.github.com/users/octocat/received_events",
                                                                                                                "type": "User",
                                                                                                                "site_admin": false
                                                                                                              },
                                                                                                              "name": "Hello-World",
                                                                                                              "full_name": "octocat/Hello-World",
                                                                                                              "description": "This your first repo!",
                                                                                                              "private": false,
                                                                                                              "fork": false,
                                                                                                              "url": "https://api.github.com/repos/octocat/Hello-World",
                                                                                                              "html_url": "https://github.com/octocat/Hello-World"
                                                                                                            }
                                                                                                          ]
                                                                                                          

                                                                                                          Create

                                                                                                          Create a new repository for the authenticated user.

                                                                                                          Note: There are two endpoints for creating a repository: one to create a repository on a user account, and one to create a repository in an organization. The organization endpoint is fully enabled for GitHub Apps, whereas the user endpoint is enabled only for user-to-server requests.

                                                                                                          POST /user/repos
                                                                                                          

                                                                                                          Create a new repository in this organization. The authenticated user must be a member of the specified organization.

                                                                                                          POST /orgs/:org/repos
                                                                                                          

                                                                                                          OAuth scope requirements

                                                                                                          When using OAuth, authorizations must include:

                                                                                                          • public_repo scope or repo scope to create a public repository
                                                                                                          • repo scope to create a private repository

                                                                                                          Input

                                                                                                          Name Type Description
                                                                                                          name string Required. The name of the repository.
                                                                                                          description string A short description of the repository.
                                                                                                          homepage string A URL with more information about the repository.
                                                                                                          private boolean Either true to create a private repository or false to create a public one. Creating private repositories requires a paid GitHub account. Default: false.
                                                                                                          has_issues boolean Either true to enable issues for this repository or false to disable them. Default: true.
                                                                                                          has_projects boolean Either true to enable projects for this repository or false to disable them. Default: true. Note: If you're creating a repository in an organization that has disabled repository projects, the default is false, and if you pass true, the API returns an error.
                                                                                                          has_wiki boolean Either true to enable the wiki for this repository or false to disable it. Default: true.
                                                                                                          team_id integer The id of the team that will be granted access to this repository. This is only valid when creating a repository in an organization.
                                                                                                          auto_init boolean Pass true to create an initial commit with empty README. Default: false.
                                                                                                          gitignore_template string Desired language or platform .gitignore template to apply. Use the name of the template without the extension. For example, "Haskell".
                                                                                                          license_template string Choose an open source license template that best suits your needs, and then use the license keyword as the license_template string. For example, "mit" or "mpl-2.0".
                                                                                                          allow_squash_merge boolean Either true to allow squash-merging pull requests, or false to prevent squash-merging. Default: true
                                                                                                          allow_merge_commit boolean Either true to allow merging pull requests with a merge commit, or false to prevent merging pull requests with merge commits. Default: true
                                                                                                          allow_rebase_merge boolean Either true to allow rebase-merging pull requests, or false to prevent rebase-merging. Default: true

                                                                                                          Example

                                                                                                          {
                                                                                                            "name": "Hello-World",
                                                                                                            "description": "This is your first repository",
                                                                                                            "homepage": "https://github.com",
                                                                                                            "private": false,
                                                                                                            "has_issues": true,
                                                                                                            "has_projects": true,
                                                                                                            "has_wiki": true
                                                                                                          }
                                                                                                          

                                                                                                          Response

                                                                                                          Status: 201 Created
                                                                                                          Location: https://api.github.com/repos/octocat/Hello-World
                                                                                                          
                                                                                                          {
                                                                                                            "id": 1296269,
                                                                                                            "owner": {
                                                                                                              "login": "octocat",
                                                                                                              "id": 1,
                                                                                                              "avatar_url": "https://github.com/images/error/octocat_happy.gif",
                                                                                                              "gravatar_id": "",
                                                                                                              "url": "https://api.github.com/users/octocat",
                                                                                                              "html_url": "https://github.com/octocat",
                                                                                                              "followers_url": "https://api.github.com/users/octocat/followers",
                                                                                                              "following_url": "https://api.github.com/users/octocat/following{/other_user}",
                                                                                                              "gists_url": "https://api.github.com/users/octocat/gists{/gist_id}",
                                                                                                              "starred_url": "https://api.github.com/users/octocat/starred{/owner}{/repo}",
                                                                                                              "subscriptions_url": "https://api.github.com/users/octocat/subscriptions",
                                                                                                              "organizations_url": "https://api.github.com/users/octocat/orgs",
                                                                                                              "repos_url": "https://api.github.com/users/octocat/repos",
                                                                                                              "events_url": "https://api.github.com/users/octocat/events{/privacy}",
                                                                                                              "received_events_url": "https://api.github.com/users/octocat/received_events",
                                                                                                              "type": "User",
                                                                                                              "site_admin": false
                                                                                                            },
                                                                                                            "name": "Hello-World",
                                                                                                            "full_name": "octocat/Hello-World",
                                                                                                            "description": "This your first repo!",
                                                                                                            "private": false,
                                                                                                            "fork": false,
                                                                                                            "url": "https://api.github.com/repos/octocat/Hello-World",
                                                                                                            "html_url": "https://github.com/octocat/Hello-World",
                                                                                                            "archive_url": "http://api.github.com/repos/octocat/Hello-World/{archive_format}{/ref}",
                                                                                                            "assignees_url": "http://api.github.com/repos/octocat/Hello-World/assignees{/user}",
                                                                                                            "blobs_url": "http://api.github.com/repos/octocat/Hello-World/git/blobs{/sha}",
                                                                                                            "branches_url": "http://api.github.com/repos/octocat/Hello-World/branches{/branch}",
                                                                                                            "clone_url": "https://github.com/octocat/Hello-World.git",
                                                                                                            "collaborators_url": "http://api.github.com/repos/octocat/Hello-World/collaborators{/collaborator}",
                                                                                                            "comments_url": "http://api.github.com/repos/octocat/Hello-World/comments{/number}",
                                                                                                            "commits_url": "http://api.github.com/repos/octocat/Hello-World/commits{/sha}",
                                                                                                            "compare_url": "http://api.github.com/repos/octocat/Hello-World/compare/{base}...{head}",
                                                                                                            "contents_url": "http://api.github.com/repos/octocat/Hello-World/contents/{+path}",
                                                                                                            "contributors_url": "http://api.github.com/repos/octocat/Hello-World/contributors",
                                                                                                            "deployments_url": "http://api.github.com/repos/octocat/Hello-World/deployments",
                                                                                                            "downloads_url": "http://api.github.com/repos/octocat/Hello-World/downloads",
                                                                                                            "events_url": "http://api.github.com/repos/octocat/Hello-World/events",
                                                                                                            "forks_url": "http://api.github.com/repos/octocat/Hello-World/forks",
                                                                                                            "git_commits_url": "http://api.github.com/repos/octocat/Hello-World/git/commits{/sha}",
                                                                                                            "git_refs_url": "http://api.github.com/repos/octocat/Hello-World/git/refs{/sha}",
                                                                                                            "git_tags_url": "http://api.github.com/repos/octocat/Hello-World/git/tags{/sha}",
                                                                                                            "git_url": "git:github.com/octocat/Hello-World.git",
                                                                                                            "hooks_url": "http://api.github.com/repos/octocat/Hello-World/hooks",
                                                                                                            "issue_comment_url": "http://api.github.com/repos/octocat/Hello-World/issues/comments{/number}",
                                                                                                            "issue_events_url": "http://api.github.com/repos/octocat/Hello-World/issues/events{/number}",
                                                                                                            "issues_url": "http://api.github.com/repos/octocat/Hello-World/issues{/number}",
                                                                                                            "keys_url": "http://api.github.com/repos/octocat/Hello-World/keys{/key_id}",
                                                                                                            "labels_url": "http://api.github.com/repos/octocat/Hello-World/labels{/name}",
                                                                                                            "languages_url": "http://api.github.com/repos/octocat/Hello-World/languages",
                                                                                                            "merges_url": "http://api.github.com/repos/octocat/Hello-World/merges",
                                                                                                            "milestones_url": "http://api.github.com/repos/octocat/Hello-World/milestones{/number}",
                                                                                                            "mirror_url": "git:git.example.com/octocat/Hello-World",
                                                                                                            "notifications_url": "http://api.github.com/repos/octocat/Hello-World/notifications{?since,all,participating}",
                                                                                                            "pulls_url": "http://api.github.com/repos/octocat/Hello-World/pulls{/number}",
                                                                                                            "releases_url": "http://api.github.com/repos/octocat/Hello-World/releases{/id}",
                                                                                                            "ssh_url": "git@github.com:octocat/Hello-World.git",
                                                                                                            "stargazers_url": "http://api.github.com/repos/octocat/Hello-World/stargazers",
                                                                                                            "statuses_url": "http://api.github.com/repos/octocat/Hello-World/statuses/{sha}",
                                                                                                            "subscribers_url": "http://api.github.com/repos/octocat/Hello-World/subscribers",
                                                                                                            "subscription_url": "http://api.github.com/repos/octocat/Hello-World/subscription",
                                                                                                            "svn_url": "https://svn.github.com/octocat/Hello-World",
                                                                                                            "tags_url": "http://api.github.com/repos/octocat/Hello-World/tags",
                                                                                                            "teams_url": "http://api.github.com/repos/octocat/Hello-World/teams",
                                                                                                            "trees_url": "http://api.github.com/repos/octocat/Hello-World/git/trees{/sha}",
                                                                                                            "homepage": "https://github.com",
                                                                                                            "language": null,
                                                                                                            "forks_count": 9,
                                                                                                            "stargazers_count": 80,
                                                                                                            "watchers_count": 80,
                                                                                                            "size": 108,
                                                                                                            "default_branch": "master",
                                                                                                            "open_issues_count": 0,
                                                                                                            "topics": [
                                                                                                              "octocat",
                                                                                                              "atom",
                                                                                                              "electron",
                                                                                                              "API"
                                                                                                            ],
                                                                                                            "has_issues": true,
                                                                                                            "has_wiki": true,
                                                                                                            "has_pages": false,
                                                                                                            "has_downloads": true,
                                                                                                            "archived": false,
                                                                                                            "pushed_at": "2011-01-26T19:06:43Z",
                                                                                                            "created_at": "2011-01-26T19:01:12Z",
                                                                                                            "updated_at": "2011-01-26T19:14:43Z",
                                                                                                            "permissions": {
                                                                                                              "admin": false,
                                                                                                              "push": false,
                                                                                                              "pull": true
                                                                                                            },
                                                                                                            "allow_rebase_merge": true,
                                                                                                            "allow_squash_merge": true,
                                                                                                            "allow_merge_commit": true,
                                                                                                            "subscribers_count": 42,
                                                                                                            "network_count": 0,
                                                                                                            "has_projects": true
                                                                                                          }
                                                                                                          

                                                                                                          Get

                                                                                                          GET /repos/:owner/:repo
                                                                                                          

                                                                                                          Response

                                                                                                          The parent and source objects are present when the repository is a fork. parent is the repository this repository was forked from, source is the ultimate source for the network.

                                                                                                          Status: 200 OK
                                                                                                          
                                                                                                          {
                                                                                                            "id": 1296269,
                                                                                                            "owner": {
                                                                                                              "login": "octocat",
                                                                                                              "id": 1,
                                                                                                              "avatar_url": "https://github.com/images/error/octocat_happy.gif",
                                                                                                              "gravatar_id": "",
                                                                                                              "url": "https://api.github.com/users/octocat",
                                                                                                              "html_url": "https://github.com/octocat",
                                                                                                              "followers_url": "https://api.github.com/users/octocat/followers",
                                                                                                              "following_url": "https://api.github.com/users/octocat/following{/other_user}",
                                                                                                              "gists_url": "https://api.github.com/users/octocat/gists{/gist_id}",
                                                                                                              "starred_url": "https://api.github.com/users/octocat/starred{/owner}{/repo}",
                                                                                                              "subscriptions_url": "https://api.github.com/users/octocat/subscriptions",
                                                                                                              "organizations_url": "https://api.github.com/users/octocat/orgs",
                                                                                                              "repos_url": "https://api.github.com/users/octocat/repos",
                                                                                                              "events_url": "https://api.github.com/users/octocat/events{/privacy}",
                                                                                                              "received_events_url": "https://api.github.com/users/octocat/received_events",
                                                                                                              "type": "User",
                                                                                                              "site_admin": false
                                                                                                            },
                                                                                                            "name": "Hello-World",
                                                                                                            "full_name": "octocat/Hello-World",
                                                                                                            "description": "This your first repo!",
                                                                                                            "private": false,
                                                                                                            "fork": false,
                                                                                                            "url": "https://api.github.com/repos/octocat/Hello-World",
                                                                                                            "html_url": "https://github.com/octocat/Hello-World",
                                                                                                            "archive_url": "http://api.github.com/repos/octocat/Hello-World/{archive_format}{/ref}",
                                                                                                            "assignees_url": "http://api.github.com/repos/octocat/Hello-World/assignees{/user}",
                                                                                                            "blobs_url": "http://api.github.com/repos/octocat/Hello-World/git/blobs{/sha}",
                                                                                                            "branches_url": "http://api.github.com/repos/octocat/Hello-World/branches{/branch}",
                                                                                                            "clone_url": "https://github.com/octocat/Hello-World.git",
                                                                                                            "collaborators_url": "http://api.github.com/repos/octocat/Hello-World/collaborators{/collaborator}",
                                                                                                            "comments_url": "http://api.github.com/repos/octocat/Hello-World/comments{/number}",
                                                                                                            "commits_url": "http://api.github.com/repos/octocat/Hello-World/commits{/sha}",
                                                                                                            "compare_url": "http://api.github.com/repos/octocat/Hello-World/compare/{base}...{head}",
                                                                                                            "contents_url": "http://api.github.com/repos/octocat/Hello-World/contents/{+path}",
                                                                                                            "contributors_url": "http://api.github.com/repos/octocat/Hello-World/contributors",
                                                                                                            "deployments_url": "http://api.github.com/repos/octocat/Hello-World/deployments",
                                                                                                            "downloads_url": "http://api.github.com/repos/octocat/Hello-World/downloads",
                                                                                                            "events_url": "http://api.github.com/repos/octocat/Hello-World/events",
                                                                                                            "forks_url": "http://api.github.com/repos/octocat/Hello-World/forks",
                                                                                                            "git_commits_url": "http://api.github.com/repos/octocat/Hello-World/git/commits{/sha}",
                                                                                                            "git_refs_url": "http://api.github.com/repos/octocat/Hello-World/git/refs{/sha}",
                                                                                                            "git_tags_url": "http://api.github.com/repos/octocat/Hello-World/git/tags{/sha}",
                                                                                                            "git_url": "git:github.com/octocat/Hello-World.git",
                                                                                                            "hooks_url": "http://api.github.com/repos/octocat/Hello-World/hooks",
                                                                                                            "issue_comment_url": "http://api.github.com/repos/octocat/Hello-World/issues/comments{/number}",
                                                                                                            "issue_events_url": "http://api.github.com/repos/octocat/Hello-World/issues/events{/number}",
                                                                                                            "issues_url": "http://api.github.com/repos/octocat/Hello-World/issues{/number}",
                                                                                                            "keys_url": "http://api.github.com/repos/octocat/Hello-World/keys{/key_id}",
                                                                                                            "labels_url": "http://api.github.com/repos/octocat/Hello-World/labels{/name}",
                                                                                                            "languages_url": "http://api.github.com/repos/octocat/Hello-World/languages",
                                                                                                            "merges_url": "http://api.github.com/repos/octocat/Hello-World/merges",
                                                                                                            "milestones_url": "http://api.github.com/repos/octocat/Hello-World/milestones{/number}",
                                                                                                            "mirror_url": "git:git.example.com/octocat/Hello-World",
                                                                                                            "notifications_url": "http://api.github.com/repos/octocat/Hello-World/notifications{?since,all,participating}",
                                                                                                            "pulls_url": "http://api.github.com/repos/octocat/Hello-World/pulls{/number}",
                                                                                                            "releases_url": "http://api.github.com/repos/octocat/Hello-World/releases{/id}",
                                                                                                            "ssh_url": "git@github.com:octocat/Hello-World.git",
                                                                                                            "stargazers_url": "http://api.github.com/repos/octocat/Hello-World/stargazers",
                                                                                                            "statuses_url": "http://api.github.com/repos/octocat/Hello-World/statuses/{sha}",
                                                                                                            "subscribers_url": "http://api.github.com/repos/octocat/Hello-World/subscribers",
                                                                                                            "subscription_url": "http://api.github.com/repos/octocat/Hello-World/subscription",
                                                                                                            "svn_url": "https://svn.github.com/octocat/Hello-World",
                                                                                                            "tags_url": "http://api.github.com/repos/octocat/Hello-World/tags",
                                                                                                            "teams_url": "http://api.github.com/repos/octocat/Hello-World/teams",
                                                                                                            "trees_url": "http://api.github.com/repos/octocat/Hello-World/git/trees{/sha}",
                                                                                                            "homepage": "https://github.com",
                                                                                                            "language": null,
                                                                                                            "forks_count": 9,
                                                                                                            "stargazers_count": 80,
                                                                                                            "watchers_count": 80,
                                                                                                            "size": 108,
                                                                                                            "default_branch": "master",
                                                                                                            "open_issues_count": 0,
                                                                                                            "topics": [
                                                                                                              "octocat",
                                                                                                              "atom",
                                                                                                              "electron",
                                                                                                              "API"
                                                                                                            ],
                                                                                                            "has_issues": true,
                                                                                                            "has_wiki": true,
                                                                                                            "has_pages": false,
                                                                                                            "has_downloads": true,
                                                                                                            "archived": false,
                                                                                                            "pushed_at": "2011-01-26T19:06:43Z",
                                                                                                            "created_at": "2011-01-26T19:01:12Z",
                                                                                                            "updated_at": "2011-01-26T19:14:43Z",
                                                                                                            "permissions": {
                                                                                                              "admin": false,
                                                                                                              "push": false,
                                                                                                              "pull": true
                                                                                                            },
                                                                                                            "allow_rebase_merge": true,
                                                                                                            "allow_squash_merge": true,
                                                                                                            "allow_merge_commit": true,
                                                                                                            "subscribers_count": 42,
                                                                                                            "network_count": 0,
                                                                                                            "license": {
                                                                                                              "key": "mit",
                                                                                                              "name": "MIT License",
                                                                                                              "spdx_id": "MIT",
                                                                                                              "url": "https://api.github.com/licenses/mit",
                                                                                                              "html_url": "http://choosealicense.com/licenses/mit/"
                                                                                                            },
                                                                                                            "organization": {
                                                                                                              "login": "octocat",
                                                                                                              "id": 1,
                                                                                                              "avatar_url": "https://github.com/images/error/octocat_happy.gif",
                                                                                                              "gravatar_id": "",
                                                                                                              "url": "https://api.github.com/users/octocat",
                                                                                                              "html_url": "https://github.com/octocat",
                                                                                                              "followers_url": "https://api.github.com/users/octocat/followers",
                                                                                                              "following_url": "https://api.github.com/users/octocat/following{/other_user}",
                                                                                                              "gists_url": "https://api.github.com/users/octocat/gists{/gist_id}",
                                                                                                              "starred_url": "https://api.github.com/users/octocat/starred{/owner}{/repo}",
                                                                                                              "subscriptions_url": "https://api.github.com/users/octocat/subscriptions",
                                                                                                              "organizations_url": "https://api.github.com/users/octocat/orgs",
                                                                                                              "repos_url": "https://api.github.com/users/octocat/repos",
                                                                                                              "events_url": "https://api.github.com/users/octocat/events{/privacy}",
                                                                                                              "received_events_url": "https://api.github.com/users/octocat/received_events",
                                                                                                              "type": "Organization",
                                                                                                              "site_admin": false
                                                                                                            },
                                                                                                            "parent": {
                                                                                                              "id": 1296269,
                                                                                                              "owner": {
                                                                                                                "login": "octocat",
                                                                                                                "id": 1,
                                                                                                                "avatar_url": "https://github.com/images/error/octocat_happy.gif",
                                                                                                                "gravatar_id": "",
                                                                                                                "url": "https://api.github.com/users/octocat",
                                                                                                                "html_url": "https://github.com/octocat",
                                                                                                                "followers_url": "https://api.github.com/users/octocat/followers",
                                                                                                                "following_url": "https://api.github.com/users/octocat/following{/other_user}",
                                                                                                                "gists_url": "https://api.github.com/users/octocat/gists{/gist_id}",
                                                                                                                "starred_url": "https://api.github.com/users/octocat/starred{/owner}{/repo}",
                                                                                                                "subscriptions_url": "https://api.github.com/users/octocat/subscriptions",
                                                                                                                "organizations_url": "https://api.github.com/users/octocat/orgs",
                                                                                                                "repos_url": "https://api.github.com/users/octocat/repos",
                                                                                                                "events_url": "https://api.github.com/users/octocat/events{/privacy}",
                                                                                                                "received_events_url": "https://api.github.com/users/octocat/received_events",
                                                                                                                "type": "User",
                                                                                                                "site_admin": false
                                                                                                              },
                                                                                                              "name": "Hello-World",
                                                                                                              "full_name": "octocat/Hello-World",
                                                                                                              "description": "This your first repo!",
                                                                                                              "private": false,
                                                                                                              "fork": false,
                                                                                                              "url": "https://api.github.com/repos/octocat/Hello-World",
                                                                                                              "html_url": "https://github.com/octocat/Hello-World",
                                                                                                              "archive_url": "http://api.github.com/repos/octocat/Hello-World/{archive_format}{/ref}",
                                                                                                              "assignees_url": "http://api.github.com/repos/octocat/Hello-World/assignees{/user}",
                                                                                                              "blobs_url": "http://api.github.com/repos/octocat/Hello-World/git/blobs{/sha}",
                                                                                                              "branches_url": "http://api.github.com/repos/octocat/Hello-World/branches{/branch}",
                                                                                                              "clone_url": "https://github.com/octocat/Hello-World.git",
                                                                                                              "collaborators_url": "http://api.github.com/repos/octocat/Hello-World/collaborators{/collaborator}",
                                                                                                              "comments_url": "http://api.github.com/repos/octocat/Hello-World/comments{/number}",
                                                                                                              "commits_url": "http://api.github.com/repos/octocat/Hello-World/commits{/sha}",
                                                                                                              "compare_url": "http://api.github.com/repos/octocat/Hello-World/compare/{base}...{head}",
                                                                                                              "contents_url": "http://api.github.com/repos/octocat/Hello-World/contents/{+path}",
                                                                                                              "contributors_url": "http://api.github.com/repos/octocat/Hello-World/contributors",
                                                                                                              "deployments_url": "http://api.github.com/repos/octocat/Hello-World/deployments",
                                                                                                              "downloads_url": "http://api.github.com/repos/octocat/Hello-World/downloads",
                                                                                                              "events_url": "http://api.github.com/repos/octocat/Hello-World/events",
                                                                                                              "forks_url": "http://api.github.com/repos/octocat/Hello-World/forks",
                                                                                                              "git_commits_url": "http://api.github.com/repos/octocat/Hello-World/git/commits{/sha}",
                                                                                                              "git_refs_url": "http://api.github.com/repos/octocat/Hello-World/git/refs{/sha}",
                                                                                                              "git_tags_url": "http://api.github.com/repos/octocat/Hello-World/git/tags{/sha}",
                                                                                                              "git_url": "git:github.com/octocat/Hello-World.git",
                                                                                                              "hooks_url": "http://api.github.com/repos/octocat/Hello-World/hooks",
                                                                                                              "issue_comment_url": "http://api.github.com/repos/octocat/Hello-World/issues/comments{/number}",
                                                                                                              "issue_events_url": "http://api.github.com/repos/octocat/Hello-World/issues/events{/number}",
                                                                                                              "issues_url": "http://api.github.com/repos/octocat/Hello-World/issues{/number}",
                                                                                                              "keys_url": "http://api.github.com/repos/octocat/Hello-World/keys{/key_id}",
                                                                                                              "labels_url": "http://api.github.com/repos/octocat/Hello-World/labels{/name}",
                                                                                                              "languages_url": "http://api.github.com/repos/octocat/Hello-World/languages",
                                                                                                              "merges_url": "http://api.github.com/repos/octocat/Hello-World/merges",
                                                                                                              "milestones_url": "http://api.github.com/repos/octocat/Hello-World/milestones{/number}",
                                                                                                              "mirror_url": "git:git.example.com/octocat/Hello-World",
                                                                                                              "notifications_url": "http://api.github.com/repos/octocat/Hello-World/notifications{?since,all,participating}",
                                                                                                              "pulls_url": "http://api.github.com/repos/octocat/Hello-World/pulls{/number}",
                                                                                                              "releases_url": "http://api.github.com/repos/octocat/Hello-World/releases{/id}",
                                                                                                              "ssh_url": "git@github.com:octocat/Hello-World.git",
                                                                                                              "stargazers_url": "http://api.github.com/repos/octocat/Hello-World/stargazers",
                                                                                                              "statuses_url": "http://api.github.com/repos/octocat/Hello-World/statuses/{sha}",
                                                                                                              "subscribers_url": "http://api.github.com/repos/octocat/Hello-World/subscribers",
                                                                                                              "subscription_url": "http://api.github.com/repos/octocat/Hello-World/subscription",
                                                                                                              "svn_url": "https://svn.github.com/octocat/Hello-World",
                                                                                                              "tags_url": "http://api.github.com/repos/octocat/Hello-World/tags",
                                                                                                              "teams_url": "http://api.github.com/repos/octocat/Hello-World/teams",
                                                                                                              "trees_url": "http://api.github.com/repos/octocat/Hello-World/git/trees{/sha}",
                                                                                                              "homepage": "https://github.com",
                                                                                                              "language": null,
                                                                                                              "forks_count": 9,
                                                                                                              "stargazers_count": 80,
                                                                                                              "watchers_count": 80,
                                                                                                              "size": 108,
                                                                                                              "default_branch": "master",
                                                                                                              "open_issues_count": 0,
                                                                                                              "topics": [
                                                                                                                "octocat",
                                                                                                                "atom",
                                                                                                                "electron",
                                                                                                                "API"
                                                                                                              ],
                                                                                                              "has_issues": true,
                                                                                                              "has_wiki": true,
                                                                                                              "has_pages": false,
                                                                                                              "has_downloads": true,
                                                                                                              "archived": false,
                                                                                                              "pushed_at": "2011-01-26T19:06:43Z",
                                                                                                              "created_at": "2011-01-26T19:01:12Z",
                                                                                                              "updated_at": "2011-01-26T19:14:43Z",
                                                                                                              "permissions": {
                                                                                                                "admin": false,
                                                                                                                "push": false,
                                                                                                                "pull": true
                                                                                                              },
                                                                                                              "allow_rebase_merge": true,
                                                                                                              "allow_squash_merge": true,
                                                                                                              "allow_merge_commit": true,
                                                                                                              "subscribers_count": 42,
                                                                                                              "network_count": 0
                                                                                                            },
                                                                                                            "source": {
                                                                                                              "id": 1296269,
                                                                                                              "owner": {
                                                                                                                "login": "octocat",
                                                                                                                "id": 1,
                                                                                                                "avatar_url": "https://github.com/images/error/octocat_happy.gif",
                                                                                                                "gravatar_id": "",
                                                                                                                "url": "https://api.github.com/users/octocat",
                                                                                                                "html_url": "https://github.com/octocat",
                                                                                                                "followers_url": "https://api.github.com/users/octocat/followers",
                                                                                                                "following_url": "https://api.github.com/users/octocat/following{/other_user}",
                                                                                                                "gists_url": "https://api.github.com/users/octocat/gists{/gist_id}",
                                                                                                                "starred_url": "https://api.github.com/users/octocat/starred{/owner}{/repo}",
                                                                                                                "subscriptions_url": "https://api.github.com/users/octocat/subscriptions",
                                                                                                                "organizations_url": "https://api.github.com/users/octocat/orgs",
                                                                                                                "repos_url": "https://api.github.com/users/octocat/repos",
                                                                                                                "events_url": "https://api.github.com/users/octocat/events{/privacy}",
                                                                                                                "received_events_url": "https://api.github.com/users/octocat/received_events",
                                                                                                                "type": "User",
                                                                                                                "site_admin": false
                                                                                                              },
                                                                                                              "name": "Hello-World",
                                                                                                              "full_name": "octocat/Hello-World",
                                                                                                              "description": "This your first repo!",
                                                                                                              "private": false,
                                                                                                              "fork": false,
                                                                                                              "url": "https://api.github.com/repos/octocat/Hello-World",
                                                                                                              "html_url": "https://github.com/octocat/Hello-World",
                                                                                                              "archive_url": "http://api.github.com/repos/octocat/Hello-World/{archive_format}{/ref}",
                                                                                                              "assignees_url": "http://api.github.com/repos/octocat/Hello-World/assignees{/user}",
                                                                                                              "blobs_url": "http://api.github.com/repos/octocat/Hello-World/git/blobs{/sha}",
                                                                                                              "branches_url": "http://api.github.com/repos/octocat/Hello-World/branches{/branch}",
                                                                                                              "clone_url": "https://github.com/octocat/Hello-World.git",
                                                                                                              "collaborators_url": "http://api.github.com/repos/octocat/Hello-World/collaborators{/collaborator}",
                                                                                                              "comments_url": "http://api.github.com/repos/octocat/Hello-World/comments{/number}",
                                                                                                              "commits_url": "http://api.github.com/repos/octocat/Hello-World/commits{/sha}",
                                                                                                              "compare_url": "http://api.github.com/repos/octocat/Hello-World/compare/{base}...{head}",
                                                                                                              "contents_url": "http://api.github.com/repos/octocat/Hello-World/contents/{+path}",
                                                                                                              "contributors_url": "http://api.github.com/repos/octocat/Hello-World/contributors",
                                                                                                              "deployments_url": "http://api.github.com/repos/octocat/Hello-World/deployments",
                                                                                                              "downloads_url": "http://api.github.com/repos/octocat/Hello-World/downloads",
                                                                                                              "events_url": "http://api.github.com/repos/octocat/Hello-World/events",
                                                                                                              "forks_url": "http://api.github.com/repos/octocat/Hello-World/forks",
                                                                                                              "git_commits_url": "http://api.github.com/repos/octocat/Hello-World/git/commits{/sha}",
                                                                                                              "git_refs_url": "http://api.github.com/repos/octocat/Hello-World/git/refs{/sha}",
                                                                                                              "git_tags_url": "http://api.github.com/repos/octocat/Hello-World/git/tags{/sha}",
                                                                                                              "git_url": "git:github.com/octocat/Hello-World.git",
                                                                                                              "hooks_url": "http://api.github.com/repos/octocat/Hello-World/hooks",
                                                                                                              "issue_comment_url": "http://api.github.com/repos/octocat/Hello-World/issues/comments{/number}",
                                                                                                              "issue_events_url": "http://api.github.com/repos/octocat/Hello-World/issues/events{/number}",
                                                                                                              "issues_url": "http://api.github.com/repos/octocat/Hello-World/issues{/number}",
                                                                                                              "keys_url": "http://api.github.com/repos/octocat/Hello-World/keys{/key_id}",
                                                                                                              "labels_url": "http://api.github.com/repos/octocat/Hello-World/labels{/name}",
                                                                                                              "languages_url": "http://api.github.com/repos/octocat/Hello-World/languages",
                                                                                                              "merges_url": "http://api.github.com/repos/octocat/Hello-World/merges",
                                                                                                              "milestones_url": "http://api.github.com/repos/octocat/Hello-World/milestones{/number}",
                                                                                                              "mirror_url": "git:git.example.com/octocat/Hello-World",
                                                                                                              "notifications_url": "http://api.github.com/repos/octocat/Hello-World/notifications{?since,all,participating}",
                                                                                                              "pulls_url": "http://api.github.com/repos/octocat/Hello-World/pulls{/number}",
                                                                                                              "releases_url": "http://api.github.com/repos/octocat/Hello-World/releases{/id}",
                                                                                                              "ssh_url": "git@github.com:octocat/Hello-World.git",
                                                                                                              "stargazers_url": "http://api.github.com/repos/octocat/Hello-World/stargazers",
                                                                                                              "statuses_url": "http://api.github.com/repos/octocat/Hello-World/statuses/{sha}",
                                                                                                              "subscribers_url": "http://api.github.com/repos/octocat/Hello-World/subscribers",
                                                                                                              "subscription_url": "http://api.github.com/repos/octocat/Hello-World/subscription",
                                                                                                              "svn_url": "https://svn.github.com/octocat/Hello-World",
                                                                                                              "tags_url": "http://api.github.com/repos/octocat/Hello-World/tags",
                                                                                                              "teams_url": "http://api.github.com/repos/octocat/Hello-World/teams",
                                                                                                              "trees_url": "http://api.github.com/repos/octocat/Hello-World/git/trees{/sha}",
                                                                                                              "homepage": "https://github.com",
                                                                                                              "language": null,
                                                                                                              "forks_count": 9,
                                                                                                              "stargazers_count": 80,
                                                                                                              "watchers_count": 80,
                                                                                                              "size": 108,
                                                                                                              "default_branch": "master",
                                                                                                              "open_issues_count": 0,
                                                                                                              "topics": [
                                                                                                                "octocat",
                                                                                                                "atom",
                                                                                                                "electron",
                                                                                                                "API"
                                                                                                              ],
                                                                                                              "has_issues": true,
                                                                                                              "has_wiki": true,
                                                                                                              "has_pages": false,
                                                                                                              "has_downloads": true,
                                                                                                              "archived": false,
                                                                                                              "pushed_at": "2011-01-26T19:06:43Z",
                                                                                                              "created_at": "2011-01-26T19:01:12Z",
                                                                                                              "updated_at": "2011-01-26T19:14:43Z",
                                                                                                              "permissions": {
                                                                                                                "admin": false,
                                                                                                                "push": false,
                                                                                                                "pull": true
                                                                                                              },
                                                                                                              "allow_rebase_merge": true,
                                                                                                              "allow_squash_merge": true,
                                                                                                              "allow_merge_commit": true,
                                                                                                              "subscribers_count": 42,
                                                                                                              "network_count": 0
                                                                                                            }
                                                                                                          }
                                                                                                          

                                                                                                          Edit

                                                                                                          PATCH /repos/:owner/:repo
                                                                                                          

                                                                                                          Note: To edit a repository's topics, use the topics endpoint.

                                                                                                          Input

                                                                                                          Name Type Description
                                                                                                          name string Required. The name of the repository.
                                                                                                          description string A short description of the repository.
                                                                                                          homepage string A URL with more information about the repository.
                                                                                                          private boolean Either true to make the repository private or false to make it public. Creating private repositories requires a paid GitHub account. Default: false.
                                                                                                          Note: You will get a 422 error if the organization restricts changing repository visibility to organization owners and a non-owner tries to change the value of private.
                                                                                                          has_issues boolean Either true to enable issues for this repository or false to disable them. Default: true.
                                                                                                          has_projects boolean Either true to enable projects for this repository or false to disable them. Default: true. Note: If you're creating a repository in an organization that has disabled repository projects, the default is false, and if you pass true, the API returns an error.
                                                                                                          has_wiki boolean Either true to enable the wiki for this repository or false to disable it. Default: true.
                                                                                                          default_branch String Updates the default branch for this repository.
                                                                                                          allow_squash_merge boolean Either true to allow squash-merging pull requests, or false to prevent squash-merging. Default: true
                                                                                                          allow_merge_commit boolean Either true to allow merging pull requests with a merge commit, or false to prevent merging pull requests with merge commits. Default: true
                                                                                                          allow_rebase_merge boolean Either true to allow rebase-merging pull requests, or false to prevent rebase-merging. Default: true
                                                                                                          archived boolean true to archive this repository. Note: You cannot unarchive repositories through the API. Default: false

                                                                                                          Example

                                                                                                          {
                                                                                                            "name": "Hello-World",
                                                                                                            "description": "This is your first repository",
                                                                                                            "homepage": "https://github.com",
                                                                                                            "private": true,
                                                                                                            "has_issues": true,
                                                                                                            "has_projects": true,
                                                                                                            "has_wiki": true
                                                                                                          }
                                                                                                          

                                                                                                          Response

                                                                                                          Status: 200 OK
                                                                                                          
                                                                                                          {
                                                                                                            "id": 1296269,
                                                                                                            "owner": {
                                                                                                              "login": "octocat",
                                                                                                              "id": 1,
                                                                                                              "avatar_url": "https://github.com/images/error/octocat_happy.gif",
                                                                                                              "gravatar_id": "",
                                                                                                              "url": "https://api.github.com/users/octocat",
                                                                                                              "html_url": "https://github.com/octocat",
                                                                                                              "followers_url": "https://api.github.com/users/octocat/followers",
                                                                                                              "following_url": "https://api.github.com/users/octocat/following{/other_user}",
                                                                                                              "gists_url": "https://api.github.com/users/octocat/gists{/gist_id}",
                                                                                                              "starred_url": "https://api.github.com/users/octocat/starred{/owner}{/repo}",
                                                                                                              "subscriptions_url": "https://api.github.com/users/octocat/subscriptions",
                                                                                                              "organizations_url": "https://api.github.com/users/octocat/orgs",
                                                                                                              "repos_url": "https://api.github.com/users/octocat/repos",
                                                                                                              "events_url": "https://api.github.com/users/octocat/events{/privacy}",
                                                                                                              "received_events_url": "https://api.github.com/users/octocat/received_events",
                                                                                                              "type": "User",
                                                                                                              "site_admin": false
                                                                                                            },
                                                                                                            "name": "Hello-World",
                                                                                                            "full_name": "octocat/Hello-World",
                                                                                                            "description": "This your first repo!",
                                                                                                            "private": false,
                                                                                                            "fork": false,
                                                                                                            "url": "https://api.github.com/repos/octocat/Hello-World",
                                                                                                            "html_url": "https://github.com/octocat/Hello-World",
                                                                                                            "archive_url": "http://api.github.com/repos/octocat/Hello-World/{archive_format}{/ref}",
                                                                                                            "assignees_url": "http://api.github.com/repos/octocat/Hello-World/assignees{/user}",
                                                                                                            "blobs_url": "http://api.github.com/repos/octocat/Hello-World/git/blobs{/sha}",
                                                                                                            "branches_url": "http://api.github.com/repos/octocat/Hello-World/branches{/branch}",
                                                                                                            "clone_url": "https://github.com/octocat/Hello-World.git",
                                                                                                            "collaborators_url": "http://api.github.com/repos/octocat/Hello-World/collaborators{/collaborator}",
                                                                                                            "comments_url": "http://api.github.com/repos/octocat/Hello-World/comments{/number}",
                                                                                                            "commits_url": "http://api.github.com/repos/octocat/Hello-World/commits{/sha}",
                                                                                                            "compare_url": "http://api.github.com/repos/octocat/Hello-World/compare/{base}...{head}",
                                                                                                            "contents_url": "http://api.github.com/repos/octocat/Hello-World/contents/{+path}",
                                                                                                            "contributors_url": "http://api.github.com/repos/octocat/Hello-World/contributors",
                                                                                                            "deployments_url": "http://api.github.com/repos/octocat/Hello-World/deployments",
                                                                                                            "downloads_url": "http://api.github.com/repos/octocat/Hello-World/downloads",
                                                                                                            "events_url": "http://api.github.com/repos/octocat/Hello-World/events",
                                                                                                            "forks_url": "http://api.github.com/repos/octocat/Hello-World/forks",
                                                                                                            "git_commits_url": "http://api.github.com/repos/octocat/Hello-World/git/commits{/sha}",
                                                                                                            "git_refs_url": "http://api.github.com/repos/octocat/Hello-World/git/refs{/sha}",
                                                                                                            "git_tags_url": "http://api.github.com/repos/octocat/Hello-World/git/tags{/sha}",
                                                                                                            "git_url": "git:github.com/octocat/Hello-World.git",
                                                                                                            "hooks_url": "http://api.github.com/repos/octocat/Hello-World/hooks",
                                                                                                            "issue_comment_url": "http://api.github.com/repos/octocat/Hello-World/issues/comments{/number}",
                                                                                                            "issue_events_url": "http://api.github.com/repos/octocat/Hello-World/issues/events{/number}",
                                                                                                            "issues_url": "http://api.github.com/repos/octocat/Hello-World/issues{/number}",
                                                                                                            "keys_url": "http://api.github.com/repos/octocat/Hello-World/keys{/key_id}",
                                                                                                            "labels_url": "http://api.github.com/repos/octocat/Hello-World/labels{/name}",
                                                                                                            "languages_url": "http://api.github.com/repos/octocat/Hello-World/languages",
                                                                                                            "merges_url": "http://api.github.com/repos/octocat/Hello-World/merges",
                                                                                                            "milestones_url": "http://api.github.com/repos/octocat/Hello-World/milestones{/number}",
                                                                                                            "mirror_url": "git:git.example.com/octocat/Hello-World",
                                                                                                            "notifications_url": "http://api.github.com/repos/octocat/Hello-World/notifications{?since,all,participating}",
                                                                                                            "pulls_url": "http://api.github.com/repos/octocat/Hello-World/pulls{/number}",
                                                                                                            "releases_url": "http://api.github.com/repos/octocat/Hello-World/releases{/id}",
                                                                                                            "ssh_url": "git@github.com:octocat/Hello-World.git",
                                                                                                            "stargazers_url": "http://api.github.com/repos/octocat/Hello-World/stargazers",
                                                                                                            "statuses_url": "http://api.github.com/repos/octocat/Hello-World/statuses/{sha}",
                                                                                                            "subscribers_url": "http://api.github.com/repos/octocat/Hello-World/subscribers",
                                                                                                            "subscription_url": "http://api.github.com/repos/octocat/Hello-World/subscription",
                                                                                                            "svn_url": "https://svn.github.com/octocat/Hello-World",
                                                                                                            "tags_url": "http://api.github.com/repos/octocat/Hello-World/tags",
                                                                                                            "teams_url": "http://api.github.com/repos/octocat/Hello-World/teams",
                                                                                                            "trees_url": "http://api.github.com/repos/octocat/Hello-World/git/trees{/sha}",
                                                                                                            "homepage": "https://github.com",
                                                                                                            "language": null,
                                                                                                            "forks_count": 9,
                                                                                                            "stargazers_count": 80,
                                                                                                            "watchers_count": 80,
                                                                                                            "size": 108,
                                                                                                            "default_branch": "master",
                                                                                                            "open_issues_count": 0,
                                                                                                            "topics": [
                                                                                                              "octocat",
                                                                                                              "atom",
                                                                                                              "electron",
                                                                                                              "API"
                                                                                                            ],
                                                                                                            "has_issues": true,
                                                                                                            "has_wiki": true,
                                                                                                            "has_pages": false,
                                                                                                            "has_downloads": true,
                                                                                                            "archived": false,
                                                                                                            "pushed_at": "2011-01-26T19:06:43Z",
                                                                                                            "created_at": "2011-01-26T19:01:12Z",
                                                                                                            "updated_at": "2011-01-26T19:14:43Z",
                                                                                                            "permissions": {
                                                                                                              "admin": false,
                                                                                                              "push": false,
                                                                                                              "pull": true
                                                                                                            },
                                                                                                            "allow_rebase_merge": true,
                                                                                                            "allow_squash_merge": true,
                                                                                                            "allow_merge_commit": true,
                                                                                                            "subscribers_count": 42,
                                                                                                            "network_count": 0,
                                                                                                            "organization": {
                                                                                                              "login": "octocat",
                                                                                                              "id": 1,
                                                                                                              "avatar_url": "https://github.com/images/error/octocat_happy.gif",
                                                                                                              "gravatar_id": "",
                                                                                                              "url": "https://api.github.com/users/octocat",
                                                                                                              "html_url": "https://github.com/octocat",
                                                                                                              "followers_url": "https://api.github.com/users/octocat/followers",
                                                                                                              "following_url": "https://api.github.com/users/octocat/following{/other_user}",
                                                                                                              "gists_url": "https://api.github.com/users/octocat/gists{/gist_id}",
                                                                                                              "starred_url": "https://api.github.com/users/octocat/starred{/owner}{/repo}",
                                                                                                              "subscriptions_url": "https://api.github.com/users/octocat/subscriptions",
                                                                                                              "organizations_url": "https://api.github.com/users/octocat/orgs",
                                                                                                              "repos_url": "https://api.github.com/users/octocat/repos",
                                                                                                              "events_url": "https://api.github.com/users/octocat/events{/privacy}",
                                                                                                              "received_events_url": "https://api.github.com/users/octocat/received_events",
                                                                                                              "type": "Organization",
                                                                                                              "site_admin": false
                                                                                                            },
                                                                                                            "parent": {
                                                                                                              "id": 1296269,
                                                                                                              "owner": {
                                                                                                                "login": "octocat",
                                                                                                                "id": 1,
                                                                                                                "avatar_url": "https://github.com/images/error/octocat_happy.gif",
                                                                                                                "gravatar_id": "",
                                                                                                                "url": "https://api.github.com/users/octocat",
                                                                                                                "html_url": "https://github.com/octocat",
                                                                                                                "followers_url": "https://api.github.com/users/octocat/followers",
                                                                                                                "following_url": "https://api.github.com/users/octocat/following{/other_user}",
                                                                                                                "gists_url": "https://api.github.com/users/octocat/gists{/gist_id}",
                                                                                                                "starred_url": "https://api.github.com/users/octocat/starred{/owner}{/repo}",
                                                                                                                "subscriptions_url": "https://api.github.com/users/octocat/subscriptions",
                                                                                                                "organizations_url": "https://api.github.com/users/octocat/orgs",
                                                                                                                "repos_url": "https://api.github.com/users/octocat/repos",
                                                                                                                "events_url": "https://api.github.com/users/octocat/events{/privacy}",
                                                                                                                "received_events_url": "https://api.github.com/users/octocat/received_events",
                                                                                                                "type": "User",
                                                                                                                "site_admin": false
                                                                                                              },
                                                                                                              "name": "Hello-World",
                                                                                                              "full_name": "octocat/Hello-World",
                                                                                                              "description": "This your first repo!",
                                                                                                              "private": false,
                                                                                                              "fork": false,
                                                                                                              "url": "https://api.github.com/repos/octocat/Hello-World",
                                                                                                              "html_url": "https://github.com/octocat/Hello-World",
                                                                                                              "archive_url": "http://api.github.com/repos/octocat/Hello-World/{archive_format}{/ref}",
                                                                                                              "assignees_url": "http://api.github.com/repos/octocat/Hello-World/assignees{/user}",
                                                                                                              "blobs_url": "http://api.github.com/repos/octocat/Hello-World/git/blobs{/sha}",
                                                                                                              "branches_url": "http://api.github.com/repos/octocat/Hello-World/branches{/branch}",
                                                                                                              "clone_url": "https://github.com/octocat/Hello-World.git",
                                                                                                              "collaborators_url": "http://api.github.com/repos/octocat/Hello-World/collaborators{/collaborator}",
                                                                                                              "comments_url": "http://api.github.com/repos/octocat/Hello-World/comments{/number}",
                                                                                                              "commits_url": "http://api.github.com/repos/octocat/Hello-World/commits{/sha}",
                                                                                                              "compare_url": "http://api.github.com/repos/octocat/Hello-World/compare/{base}...{head}",
                                                                                                              "contents_url": "http://api.github.com/repos/octocat/Hello-World/contents/{+path}",
                                                                                                              "contributors_url": "http://api.github.com/repos/octocat/Hello-World/contributors",
                                                                                                              "deployments_url": "http://api.github.com/repos/octocat/Hello-World/deployments",
                                                                                                              "downloads_url": "http://api.github.com/repos/octocat/Hello-World/downloads",
                                                                                                              "events_url": "http://api.github.com/repos/octocat/Hello-World/events",
                                                                                                              "forks_url": "http://api.github.com/repos/octocat/Hello-World/forks",
                                                                                                              "git_commits_url": "http://api.github.com/repos/octocat/Hello-World/git/commits{/sha}",
                                                                                                              "git_refs_url": "http://api.github.com/repos/octocat/Hello-World/git/refs{/sha}",
                                                                                                              "git_tags_url": "http://api.github.com/repos/octocat/Hello-World/git/tags{/sha}",
                                                                                                              "git_url": "git:github.com/octocat/Hello-World.git",
                                                                                                              "hooks_url": "http://api.github.com/repos/octocat/Hello-World/hooks",
                                                                                                              "issue_comment_url": "http://api.github.com/repos/octocat/Hello-World/issues/comments{/number}",
                                                                                                              "issue_events_url": "http://api.github.com/repos/octocat/Hello-World/issues/events{/number}",
                                                                                                              "issues_url": "http://api.github.com/repos/octocat/Hello-World/issues{/number}",
                                                                                                              "keys_url": "http://api.github.com/repos/octocat/Hello-World/keys{/key_id}",
                                                                                                              "labels_url": "http://api.github.com/repos/octocat/Hello-World/labels{/name}",
                                                                                                              "languages_url": "http://api.github.com/repos/octocat/Hello-World/languages",
                                                                                                              "merges_url": "http://api.github.com/repos/octocat/Hello-World/merges",
                                                                                                              "milestones_url": "http://api.github.com/repos/octocat/Hello-World/milestones{/number}",
                                                                                                              "mirror_url": "git:git.example.com/octocat/Hello-World",
                                                                                                              "notifications_url": "http://api.github.com/repos/octocat/Hello-World/notifications{?since,all,participating}",
                                                                                                              "pulls_url": "http://api.github.com/repos/octocat/Hello-World/pulls{/number}",
                                                                                                              "releases_url": "http://api.github.com/repos/octocat/Hello-World/releases{/id}",
                                                                                                              "ssh_url": "git@github.com:octocat/Hello-World.git",
                                                                                                              "stargazers_url": "http://api.github.com/repos/octocat/Hello-World/stargazers",
                                                                                                              "statuses_url": "http://api.github.com/repos/octocat/Hello-World/statuses/{sha}",
                                                                                                              "subscribers_url": "http://api.github.com/repos/octocat/Hello-World/subscribers",
                                                                                                              "subscription_url": "http://api.github.com/repos/octocat/Hello-World/subscription",
                                                                                                              "svn_url": "https://svn.github.com/octocat/Hello-World",
                                                                                                              "tags_url": "http://api.github.com/repos/octocat/Hello-World/tags",
                                                                                                              "teams_url": "http://api.github.com/repos/octocat/Hello-World/teams",
                                                                                                              "trees_url": "http://api.github.com/repos/octocat/Hello-World/git/trees{/sha}",
                                                                                                              "homepage": "https://github.com",
                                                                                                              "language": null,
                                                                                                              "forks_count": 9,
                                                                                                              "stargazers_count": 80,
                                                                                                              "watchers_count": 80,
                                                                                                              "size": 108,
                                                                                                              "default_branch": "master",
                                                                                                              "open_issues_count": 0,
                                                                                                              "topics": [
                                                                                                                "octocat",
                                                                                                                "atom",
                                                                                                                "electron",
                                                                                                                "API"
                                                                                                              ],
                                                                                                              "has_issues": true,
                                                                                                              "has_wiki": true,
                                                                                                              "has_pages": false,
                                                                                                              "has_downloads": true,
                                                                                                              "archived": false,
                                                                                                              "pushed_at": "2011-01-26T19:06:43Z",
                                                                                                              "created_at": "2011-01-26T19:01:12Z",
                                                                                                              "updated_at": "2011-01-26T19:14:43Z",
                                                                                                              "permissions": {
                                                                                                                "admin": false,
                                                                                                                "push": false,
                                                                                                                "pull": true
                                                                                                              },
                                                                                                              "allow_rebase_merge": true,
                                                                                                              "allow_squash_merge": true,
                                                                                                              "allow_merge_commit": true,
                                                                                                              "subscribers_count": 42,
                                                                                                              "network_count": 0
                                                                                                            },
                                                                                                            "source": {
                                                                                                              "id": 1296269,
                                                                                                              "owner": {
                                                                                                                "login": "octocat",
                                                                                                                "id": 1,
                                                                                                                "avatar_url": "https://github.com/images/error/octocat_happy.gif",
                                                                                                                "gravatar_id": "",
                                                                                                                "url": "https://api.github.com/users/octocat",
                                                                                                                "html_url": "https://github.com/octocat",
                                                                                                                "followers_url": "https://api.github.com/users/octocat/followers",
                                                                                                                "following_url": "https://api.github.com/users/octocat/following{/other_user}",
                                                                                                                "gists_url": "https://api.github.com/users/octocat/gists{/gist_id}",
                                                                                                                "starred_url": "https://api.github.com/users/octocat/starred{/owner}{/repo}",
                                                                                                                "subscriptions_url": "https://api.github.com/users/octocat/subscriptions",
                                                                                                                "organizations_url": "https://api.github.com/users/octocat/orgs",
                                                                                                                "repos_url": "https://api.github.com/users/octocat/repos",
                                                                                                                "events_url": "https://api.github.com/users/octocat/events{/privacy}",
                                                                                                                "received_events_url": "https://api.github.com/users/octocat/received_events",
                                                                                                                "type": "User",
                                                                                                                "site_admin": false
                                                                                                              },
                                                                                                              "name": "Hello-World",
                                                                                                              "full_name": "octocat/Hello-World",
                                                                                                              "description": "This your first repo!",
                                                                                                              "private": false,
                                                                                                              "fork": false,
                                                                                                              "url": "https://api.github.com/repos/octocat/Hello-World",
                                                                                                              "html_url": "https://github.com/octocat/Hello-World",
                                                                                                              "archive_url": "http://api.github.com/repos/octocat/Hello-World/{archive_format}{/ref}",
                                                                                                              "assignees_url": "http://api.github.com/repos/octocat/Hello-World/assignees{/user}",
                                                                                                              "blobs_url": "http://api.github.com/repos/octocat/Hello-World/git/blobs{/sha}",
                                                                                                              "branches_url": "http://api.github.com/repos/octocat/Hello-World/branches{/branch}",
                                                                                                              "clone_url": "https://github.com/octocat/Hello-World.git",
                                                                                                              "collaborators_url": "http://api.github.com/repos/octocat/Hello-World/collaborators{/collaborator}",
                                                                                                              "comments_url": "http://api.github.com/repos/octocat/Hello-World/comments{/number}",
                                                                                                              "commits_url": "http://api.github.com/repos/octocat/Hello-World/commits{/sha}",
                                                                                                              "compare_url": "http://api.github.com/repos/octocat/Hello-World/compare/{base}...{head}",
                                                                                                              "contents_url": "http://api.github.com/repos/octocat/Hello-World/contents/{+path}",
                                                                                                              "contributors_url": "http://api.github.com/repos/octocat/Hello-World/contributors",
                                                                                                              "deployments_url": "http://api.github.com/repos/octocat/Hello-World/deployments",
                                                                                                              "downloads_url": "http://api.github.com/repos/octocat/Hello-World/downloads",
                                                                                                              "events_url": "http://api.github.com/repos/octocat/Hello-World/events",
                                                                                                              "forks_url": "http://api.github.com/repos/octocat/Hello-World/forks",
                                                                                                              "git_commits_url": "http://api.github.com/repos/octocat/Hello-World/git/commits{/sha}",
                                                                                                              "git_refs_url": "http://api.github.com/repos/octocat/Hello-World/git/refs{/sha}",
                                                                                                              "git_tags_url": "http://api.github.com/repos/octocat/Hello-World/git/tags{/sha}",
                                                                                                              "git_url": "git:github.com/octocat/Hello-World.git",
                                                                                                              "hooks_url": "http://api.github.com/repos/octocat/Hello-World/hooks",
                                                                                                              "issue_comment_url": "http://api.github.com/repos/octocat/Hello-World/issues/comments{/number}",
                                                                                                              "issue_events_url": "http://api.github.com/repos/octocat/Hello-World/issues/events{/number}",
                                                                                                              "issues_url": "http://api.github.com/repos/octocat/Hello-World/issues{/number}",
                                                                                                              "keys_url": "http://api.github.com/repos/octocat/Hello-World/keys{/key_id}",
                                                                                                              "labels_url": "http://api.github.com/repos/octocat/Hello-World/labels{/name}",
                                                                                                              "languages_url": "http://api.github.com/repos/octocat/Hello-World/languages",
                                                                                                              "merges_url": "http://api.github.com/repos/octocat/Hello-World/merges",
                                                                                                              "milestones_url": "http://api.github.com/repos/octocat/Hello-World/milestones{/number}",
                                                                                                              "mirror_url": "git:git.example.com/octocat/Hello-World",
                                                                                                              "notifications_url": "http://api.github.com/repos/octocat/Hello-World/notifications{?since,all,participating}",
                                                                                                              "pulls_url": "http://api.github.com/repos/octocat/Hello-World/pulls{/number}",
                                                                                                              "releases_url": "http://api.github.com/repos/octocat/Hello-World/releases{/id}",
                                                                                                              "ssh_url": "git@github.com:octocat/Hello-World.git",
                                                                                                              "stargazers_url": "http://api.github.com/repos/octocat/Hello-World/stargazers",
                                                                                                              "statuses_url": "http://api.github.com/repos/octocat/Hello-World/statuses/{sha}",
                                                                                                              "subscribers_url": "http://api.github.com/repos/octocat/Hello-World/subscribers",
                                                                                                              "subscription_url": "http://api.github.com/repos/octocat/Hello-World/subscription",
                                                                                                              "svn_url": "https://svn.github.com/octocat/Hello-World",
                                                                                                              "tags_url": "http://api.github.com/repos/octocat/Hello-World/tags",
                                                                                                              "teams_url": "http://api.github.com/repos/octocat/Hello-World/teams",
                                                                                                              "trees_url": "http://api.github.com/repos/octocat/Hello-World/git/trees{/sha}",
                                                                                                              "homepage": "https://github.com",
                                                                                                              "language": null,
                                                                                                              "forks_count": 9,
                                                                                                              "stargazers_count": 80,
                                                                                                              "watchers_count": 80,
                                                                                                              "size": 108,
                                                                                                              "default_branch": "master",
                                                                                                              "open_issues_count": 0,
                                                                                                              "topics": [
                                                                                                                "octocat",
                                                                                                                "atom",
                                                                                                                "electron",
                                                                                                                "API"
                                                                                                              ],
                                                                                                              "has_issues": true,
                                                                                                              "has_wiki": true,
                                                                                                              "has_pages": false,
                                                                                                              "has_downloads": true,
                                                                                                              "archived": false,
                                                                                                              "pushed_at": "2011-01-26T19:06:43Z",
                                                                                                              "created_at": "2011-01-26T19:01:12Z",
                                                                                                              "updated_at": "2011-01-26T19:14:43Z",
                                                                                                              "permissions": {
                                                                                                                "admin": false,
                                                                                                                "push": false,
                                                                                                                "pull": true
                                                                                                              },
                                                                                                              "allow_rebase_merge": true,
                                                                                                              "allow_squash_merge": true,
                                                                                                              "allow_merge_commit": true,
                                                                                                              "subscribers_count": 42,
                                                                                                              "network_count": 0
                                                                                                            },
                                                                                                            "has_projects": true
                                                                                                          }
                                                                                                          

                                                                                                          List all topics for a repository

                                                                                                          Note: The topics property for repositories on GitHub is currently available for developers to preview. To view the topics property in calls that return repository results, you must provide a custom media type in the Accept header:

                                                                                                          application/vnd.github.mercy-preview+json
                                                                                                          

                                                                                                          Warning: The API may change without advance notice during the preview period. Preview features are not supported for production use. If you experience any issues, contact GitHub support.

                                                                                                          GET /repos/:owner/:repo/topics
                                                                                                          

                                                                                                          Response

                                                                                                          Status: 200 OK
                                                                                                          
                                                                                                          {
                                                                                                            "names": [
                                                                                                              "octocat",
                                                                                                              "atom",
                                                                                                              "electron",
                                                                                                              "API"
                                                                                                            ]
                                                                                                          }
                                                                                                          

                                                                                                          Replace all topics for a repository

                                                                                                          Note: The topics property for repositories on GitHub is currently available for developers to preview. To view the topics property in calls that return repository results, you must provide a custom media type in the Accept header:

                                                                                                          application/vnd.github.mercy-preview+json
                                                                                                          

                                                                                                          Warning: The API may change without advance notice during the preview period. Preview features are not supported for production use. If you experience any issues, contact GitHub support.

                                                                                                          PUT /repos/:owner/:repo/topics
                                                                                                          

                                                                                                          Input

                                                                                                          Name Type Description
                                                                                                          names array of strings Required. An array of topics to add to the repository. Pass one or more topics to replace the set of existing topics. Send an empty array ([]) to clear all topics from the repository.

                                                                                                          Example

                                                                                                          {
                                                                                                            "names": [
                                                                                                              "octocat",
                                                                                                              "atom",
                                                                                                              "electron",
                                                                                                              "API"
                                                                                                            ]
                                                                                                          }
                                                                                                          

                                                                                                          Response

                                                                                                          Status: 200 OK
                                                                                                          
                                                                                                          {
                                                                                                            "names": [
                                                                                                              "octocat",
                                                                                                              "atom",
                                                                                                              "electron",
                                                                                                              "API"
                                                                                                            ]
                                                                                                          }
                                                                                                          

                                                                                                          List contributors

                                                                                                          Lists contributors to the specified repository and sorts them by the number of commits per contributor in descending order. This endpoint may return information that is a few hours old because the GitHub REST API v3 caches contributor data to improve performance.

                                                                                                          GitHub identifies contributors by author email address. This endpoint groups contribution counts by GitHub user, which includes all associated email addresses. To improve performance, only the first 500 author email addresses in the repository link to GitHub users. The rest will appear as anonymous contributors without associated GitHub user information.

                                                                                                          GET /repos/:owner/:repo/contributors
                                                                                                          

                                                                                                          Parameters

                                                                                                          Name Type Description
                                                                                                          anon string Set to 1 or true to include anonymous contributors in results.

                                                                                                          Response if repository is empty

                                                                                                          Status: 204 No Content
                                                                                                          

                                                                                                          Response if repository contains content

                                                                                                          Status: 200 OK
                                                                                                          Link: <https://api.github.com/resource?page=2>; rel="next",
                                                                                                                <https://api.github.com/resource?page=5>; rel="last"
                                                                                                          
                                                                                                          [
                                                                                                            {
                                                                                                              "login": "octocat",
                                                                                                              "id": 1,
                                                                                                              "avatar_url": "https://github.com/images/error/octocat_happy.gif",
                                                                                                              "gravatar_id": "",
                                                                                                              "url": "https://api.github.com/users/octocat",
                                                                                                              "html_url": "https://github.com/octocat",
                                                                                                              "followers_url": "https://api.github.com/users/octocat/followers",
                                                                                                              "following_url": "https://api.github.com/users/octocat/following{/other_user}",
                                                                                                              "gists_url": "https://api.github.com/users/octocat/gists{/gist_id}",
                                                                                                              "starred_url": "https://api.github.com/users/octocat/starred{/owner}{/repo}",
                                                                                                              "subscriptions_url": "https://api.github.com/users/octocat/subscriptions",
                                                                                                              "organizations_url": "https://api.github.com/users/octocat/orgs",
                                                                                                              "repos_url": "https://api.github.com/users/octocat/repos",
                                                                                                              "events_url": "https://api.github.com/users/octocat/events{/privacy}",
                                                                                                              "received_events_url": "https://api.github.com/users/octocat/received_events",
                                                                                                              "type": "User",
                                                                                                              "site_admin": false,
                                                                                                              "contributions": 32
                                                                                                            }
                                                                                                          ]
                                                                                                          

                                                                                                          List languages

                                                                                                          Lists languages for the specified repository. The value shown for each language is the number of bytes of code written in that language.

                                                                                                          GET /repos/:owner/:repo/languages
                                                                                                          

                                                                                                          Response

                                                                                                          Status: 200 OK
                                                                                                          
                                                                                                          {
                                                                                                            "C": 78769,
                                                                                                            "Python": 7769
                                                                                                          }
                                                                                                          

                                                                                                          List teams

                                                                                                          Note: The Nested Teams API is currently available for developers to preview. See the blog post for full details. To access the API, you must provide a custom media type in the Accept header:

                                                                                                          application/vnd.github.hellcat-preview+json
                                                                                                          

                                                                                                          Warning: The API may change without advance notice during the preview period. Preview features are not supported for production use. If you experience any issues, contact GitHub support.

                                                                                                          GET /repos/:owner/:repo/teams
                                                                                                          

                                                                                                          Response

                                                                                                          Status: 200 OK
                                                                                                          Link: <https://api.github.com/resource?page=2>; rel="next",
                                                                                                                <https://api.github.com/resource?page=5>; rel="last"
                                                                                                          
                                                                                                          [
                                                                                                            {
                                                                                                              "id": 1,
                                                                                                              "url": "https://api.github.com/teams/1",
                                                                                                              "name": "Justice League",
                                                                                                              "slug": "justice-league",
                                                                                                              "description": "A great team.",
                                                                                                              "privacy": "closed",
                                                                                                              "permission": "admin",
                                                                                                              "members_url": "https://api.github.com/teams/1/members{/member}",
                                                                                                              "repositories_url": "https://api.github.com/teams/1/repos",
                                                                                                              "parent": null
                                                                                                            }
                                                                                                          ]
                                                                                                          

                                                                                                          List tags

                                                                                                          GET /repos/:owner/:repo/tags
                                                                                                          

                                                                                                          Response

                                                                                                          Status: 200 OK
                                                                                                          Link: <https://api.github.com/resource?page=2>; rel="next",
                                                                                                                <https://api.github.com/resource?page=5>; rel="last"
                                                                                                          
                                                                                                          [
                                                                                                            {
                                                                                                              "name": "v0.1",
                                                                                                              "commit": {
                                                                                                                "sha": "c5b97d5ae6c19d5c5df71a34c7fbeeda2479ccbc",
                                                                                                                "url": "https://api.github.com/repos/octocat/Hello-World/commits/c5b97d5ae6c19d5c5df71a34c7fbeeda2479ccbc"
                                                                                                              },
                                                                                                              "zipball_url": "https://github.com/octocat/Hello-World/zipball/v0.1",
                                                                                                              "tarball_url": "https://github.com/octocat/Hello-World/tarball/v0.1"
                                                                                                            }
                                                                                                          ]
                                                                                                          

                                                                                                          Delete a repository

                                                                                                          Deleting a repository requires admin access. If OAuth is used, the delete_repo scope is required.

                                                                                                          DELETE /repos/:owner/:repo
                                                                                                          

                                                                                                          Response

                                                                                                          Status: 204 No Content
                                                                                                          

                                                                                                          If an organization owner has configured the organization to prevent members from deleting organization-owned repositories, a member will get this response:

                                                                                                          Status: 403 Forbidden
                                                                                                          
                                                                                                          {
                                                                                                            "message": "Organization members cannot delete repositories.",
                                                                                                            "documentation_url": "https://developer.github.com/v3/repos/#delete-a-repository"
                                                                                                          }
                                                                                                          

                                                                                                          Transfer a repository

                                                                                                          A transfer request will need to be accepted by the new owner when transferring a personal repository to another user. The response will contain the original owner, and the transfer will continue asynchronously. For more details on the requirements to transfer personal and organization-owned repositories, see about repository transfers.

                                                                                                          Note: The Repository Transfer API is currently available for developers to preview. To access the API, you must provide a custom media type in the Accept header:

                                                                                                          application/vnd.github.nightshade-preview+json
                                                                                                          

                                                                                                          Warning: The API may change without advance notice during the preview period. Preview features are not supported for production use. If you experience any issues, contact GitHub support.

                                                                                                          POST /repos/:owner/:repo/transfer
                                                                                                          

                                                                                                          Input

                                                                                                          Name Type Description
                                                                                                          new_owner string Required: The username or organization name the repository will be transferred to.
                                                                                                          team_id array of integers ID of the team or teams to add to the repository. Teams can only be added to organization-owned repositories.

                                                                                                          Example

                                                                                                          {
                                                                                                            "new_owner": "github",
                                                                                                            "team_id": [
                                                                                                              12,
                                                                                                              345
                                                                                                            ]
                                                                                                          }
                                                                                                          

                                                                                                          Response

                                                                                                          Status: 202 Accepted
                                                                                                          
                                                                                                          {
                                                                                                            "id": 1296269,
                                                                                                            "owner": {
                                                                                                              "login": "octocat",
                                                                                                              "id": 1,
                                                                                                              "avatar_url": "https://github.com/images/error/octocat_happy.gif",
                                                                                                              "gravatar_id": "",
                                                                                                              "url": "https://api.github.com/users/octocat",
                                                                                                              "html_url": "https://github.com/octocat",
                                                                                                              "followers_url": "https://api.github.com/users/octocat/followers",
                                                                                                              "following_url": "https://api.github.com/users/octocat/following{/other_user}",
                                                                                                              "gists_url": "https://api.github.com/users/octocat/gists{/gist_id}",
                                                                                                              "starred_url": "https://api.github.com/users/octocat/starred{/owner}{/repo}",
                                                                                                              "subscriptions_url": "https://api.github.com/users/octocat/subscriptions",
                                                                                                              "organizations_url": "https://api.github.com/users/octocat/orgs",
                                                                                                              "repos_url": "https://api.github.com/users/octocat/repos",
                                                                                                              "events_url": "https://api.github.com/users/octocat/events{/privacy}",
                                                                                                              "received_events_url": "https://api.github.com/users/octocat/received_events",
                                                                                                              "type": "User",
                                                                                                              "site_admin": false
                                                                                                            },
                                                                                                            "name": "Hello-World",
                                                                                                            "full_name": "octocat/Hello-World",
                                                                                                            "description": "This your first repo!",
                                                                                                            "private": false,
                                                                                                            "fork": false,
                                                                                                            "url": "https://api.github.com/repos/octocat/Hello-World",
                                                                                                            "html_url": "https://github.com/octocat/Hello-World",
                                                                                                            "archive_url": "http://api.github.com/repos/octocat/Hello-World/{archive_format}{/ref}",
                                                                                                            "assignees_url": "http://api.github.com/repos/octocat/Hello-World/assignees{/user}",
                                                                                                            "blobs_url": "http://api.github.com/repos/octocat/Hello-World/git/blobs{/sha}",
                                                                                                            "branches_url": "http://api.github.com/repos/octocat/Hello-World/branches{/branch}",
                                                                                                            "clone_url": "https://github.com/octocat/Hello-World.git",
                                                                                                            "collaborators_url": "http://api.github.com/repos/octocat/Hello-World/collaborators{/collaborator}",
                                                                                                            "comments_url": "http://api.github.com/repos/octocat/Hello-World/comments{/number}",
                                                                                                            "commits_url": "http://api.github.com/repos/octocat/Hello-World/commits{/sha}",
                                                                                                            "compare_url": "http://api.github.com/repos/octocat/Hello-World/compare/{base}...{head}",
                                                                                                            "contents_url": "http://api.github.com/repos/octocat/Hello-World/contents/{+path}",
                                                                                                            "contributors_url": "http://api.github.com/repos/octocat/Hello-World/contributors",
                                                                                                            "deployments_url": "http://api.github.com/repos/octocat/Hello-World/deployments",
                                                                                                            "downloads_url": "http://api.github.com/repos/octocat/Hello-World/downloads",
                                                                                                            "events_url": "http://api.github.com/repos/octocat/Hello-World/events",
                                                                                                            "forks_url": "http://api.github.com/repos/octocat/Hello-World/forks",
                                                                                                            "git_commits_url": "http://api.github.com/repos/octocat/Hello-World/git/commits{/sha}",
                                                                                                            "git_refs_url": "http://api.github.com/repos/octocat/Hello-World/git/refs{/sha}",
                                                                                                            "git_tags_url": "http://api.github.com/repos/octocat/Hello-World/git/tags{/sha}",
                                                                                                            "git_url": "git:github.com/octocat/Hello-World.git",
                                                                                                            "hooks_url": "http://api.github.com/repos/octocat/Hello-World/hooks",
                                                                                                            "issue_comment_url": "http://api.github.com/repos/octocat/Hello-World/issues/comments{/number}",
                                                                                                            "issue_events_url": "http://api.github.com/repos/octocat/Hello-World/issues/events{/number}",
                                                                                                            "issues_url": "http://api.github.com/repos/octocat/Hello-World/issues{/number}",
                                                                                                            "keys_url": "http://api.github.com/repos/octocat/Hello-World/keys{/key_id}",
                                                                                                            "labels_url": "http://api.github.com/repos/octocat/Hello-World/labels{/name}",
                                                                                                            "languages_url": "http://api.github.com/repos/octocat/Hello-World/languages",
                                                                                                            "merges_url": "http://api.github.com/repos/octocat/Hello-World/merges",
                                                                                                            "milestones_url": "http://api.github.com/repos/octocat/Hello-World/milestones{/number}",
                                                                                                            "mirror_url": "git:git.example.com/octocat/Hello-World",
                                                                                                            "notifications_url": "http://api.github.com/repos/octocat/Hello-World/notifications{?since,all,participating}",
                                                                                                            "pulls_url": "http://api.github.com/repos/octocat/Hello-World/pulls{/number}",
                                                                                                            "releases_url": "http://api.github.com/repos/octocat/Hello-World/releases{/id}",
                                                                                                            "ssh_url": "git@github.com:octocat/Hello-World.git",
                                                                                                            "stargazers_url": "http://api.github.com/repos/octocat/Hello-World/stargazers",
                                                                                                            "statuses_url": "http://api.github.com/repos/octocat/Hello-World/statuses/{sha}",
                                                                                                            "subscribers_url": "http://api.github.com/repos/octocat/Hello-World/subscribers",
                                                                                                            "subscription_url": "http://api.github.com/repos/octocat/Hello-World/subscription",
                                                                                                            "svn_url": "https://svn.github.com/octocat/Hello-World",
                                                                                                            "tags_url": "http://api.github.com/repos/octocat/Hello-World/tags",
                                                                                                            "teams_url": "http://api.github.com/repos/octocat/Hello-World/teams",
                                                                                                            "trees_url": "http://api.github.com/repos/octocat/Hello-World/git/trees{/sha}",
                                                                                                            "homepage": "https://github.com",
                                                                                                            "language": null,
                                                                                                            "forks_count": 9,
                                                                                                            "stargazers_count": 80,
                                                                                                            "watchers_count": 80,
                                                                                                            "size": 108,
                                                                                                            "default_branch": "master",
                                                                                                            "open_issues_count": 0,
                                                                                                            "topics": [
                                                                                                              "octocat",
                                                                                                              "atom",
                                                                                                              "electron",
                                                                                                              "API"
                                                                                                            ],
                                                                                                            "has_issues": true,
                                                                                                            "has_wiki": true,
                                                                                                            "has_pages": false,
                                                                                                            "has_downloads": true,
                                                                                                            "archived": false,
                                                                                                            "pushed_at": "2011-01-26T19:06:43Z",
                                                                                                            "created_at": "2011-01-26T19:01:12Z",
                                                                                                            "updated_at": "2011-01-26T19:14:43Z",
                                                                                                            "permissions": {
                                                                                                              "admin": false,
                                                                                                              "push": false,
                                                                                                              "pull": true
                                                                                                            },
                                                                                                            "allow_rebase_merge": true,
                                                                                                            "allow_squash_merge": true,
                                                                                                            "allow_merge_commit": true,
                                                                                                            "subscribers_count": 42,
                                                                                                            "network_count": 0
                                                                                                          }
                                                                                                          
                                                                                                          tmp/developer.github.com/v3/repos/branches/index.html Branches | GitHub Developer Guide

                                                                                                          Branches

                                                                                                          List branches

                                                                                                          GET /repos/:owner/:repo/branches
                                                                                                          

                                                                                                          Parameters

                                                                                                          Name Type Description
                                                                                                          protected boolean Set to true to only return protected branches

                                                                                                          Response

                                                                                                          Status: 200 OK
                                                                                                          Link: <https://api.github.com/resource?page=2>; rel="next",
                                                                                                                <https://api.github.com/resource?page=5>; rel="last"
                                                                                                          
                                                                                                          [
                                                                                                            {
                                                                                                              "name": "master",
                                                                                                              "commit": {
                                                                                                                "sha": "6dcb09b5b57875f334f61aebed695e2e4193db5e",
                                                                                                                "url": "https://api.github.com/repos/octocat/Hello-World/commits/c5b97d5ae6c19d5c5df71a34c7fbeeda2479ccbc"
                                                                                                              },
                                                                                                              "protected": true,
                                                                                                              "protection_url": "https://api.github.com/repos/octocat/Hello-World/branches/master/protection"
                                                                                                            }
                                                                                                          ]
                                                                                                          

                                                                                                          Get branch

                                                                                                          GET /repos/:owner/:repo/branches/:branch
                                                                                                          

                                                                                                          Response

                                                                                                          Status: 200 OK
                                                                                                          
                                                                                                          {
                                                                                                            "name": "master",
                                                                                                            "commit": {
                                                                                                              "sha": "7fd1a60b01f91b314f59955a4e4d4e80d8edf11d",
                                                                                                              "commit": {
                                                                                                                "author": {
                                                                                                                  "name": "The Octocat",
                                                                                                                  "date": "2012-03-06T15:06:50-08:00",
                                                                                                                  "email": "octocat@nowhere.com"
                                                                                                                },
                                                                                                                "url": "https://api.github.com/repos/octocat/Hello-World/git/commits/7fd1a60b01f91b314f59955a4e4d4e80d8edf11d",
                                                                                                                "message": "Merge pull request #6 from Spaceghost/patch-1\n\nNew line at end of file.",
                                                                                                                "tree": {
                                                                                                                  "sha": "b4eecafa9be2f2006ce1b709d6857b07069b4608",
                                                                                                                  "url": "https://api.github.com/repos/octocat/Hello-World/git/trees/b4eecafa9be2f2006ce1b709d6857b07069b4608"
                                                                                                                },
                                                                                                                "committer": {
                                                                                                                  "name": "The Octocat",
                                                                                                                  "date": "2012-03-06T15:06:50-08:00",
                                                                                                                  "email": "octocat@nowhere.com"
                                                                                                                },
                                                                                                                "verification": {
                                                                                                                  "verified": false,
                                                                                                                  "reason": "unsigned",
                                                                                                                  "signature": null,
                                                                                                                  "payload": null
                                                                                                                }
                                                                                                              },
                                                                                                              "author": {
                                                                                                                "gravatar_id": "",
                                                                                                                "avatar_url": "https://secure.gravatar.com/avatar/7ad39074b0584bc555d0417ae3e7d974?d=https://a248.e.akamai.net/assets.github.com%2Fimages%2Fgravatars%2Fgravatar-140.png",
                                                                                                                "url": "https://api.github.com/users/octocat",
                                                                                                                "id": 583231,
                                                                                                                "login": "octocat"
                                                                                                              },
                                                                                                              "parents": [
                                                                                                                {
                                                                                                                  "sha": "553c2077f0edc3d5dc5d17262f6aa498e69d6f8e",
                                                                                                                  "url": "https://api.github.com/repos/octocat/Hello-World/commits/553c2077f0edc3d5dc5d17262f6aa498e69d6f8e"
                                                                                                                },
                                                                                                                {
                                                                                                                  "sha": "762941318ee16e59dabbacb1b4049eec22f0d303",
                                                                                                                  "url": "https://api.github.com/repos/octocat/Hello-World/commits/762941318ee16e59dabbacb1b4049eec22f0d303"
                                                                                                                }
                                                                                                              ],
                                                                                                              "url": "https://api.github.com/repos/octocat/Hello-World/commits/7fd1a60b01f91b314f59955a4e4d4e80d8edf11d",
                                                                                                              "committer": {
                                                                                                                "gravatar_id": "",
                                                                                                                "avatar_url": "https://secure.gravatar.com/avatar/7ad39074b0584bc555d0417ae3e7d974?d=https://a248.e.akamai.net/assets.github.com%2Fimages%2Fgravatars%2Fgravatar-140.png",
                                                                                                                "url": "https://api.github.com/users/octocat",
                                                                                                                "id": 583231,
                                                                                                                "login": "octocat"
                                                                                                              }
                                                                                                            },
                                                                                                            "_links": {
                                                                                                              "html": "https://github.com/octocat/Hello-World/tree/master",
                                                                                                              "self": "https://api.github.com/repos/octocat/Hello-World/branches/master"
                                                                                                            },
                                                                                                            "protected": true,
                                                                                                            "protection_url": "https://api.github.com/repos/octocat/Hello-World/branches/master/protection"
                                                                                                          }
                                                                                                          

                                                                                                          Get branch protection

                                                                                                          GET /repos/:owner/:repo/branches/:branch/protection
                                                                                                          
                                                                                                          Status: 200 OK
                                                                                                          
                                                                                                          {
                                                                                                            "url": "https://api.github.com/repos/octocat/Hello-World/branches/master/protection",
                                                                                                            "required_status_checks": {
                                                                                                              "url": "https://api.github.com/repos/octocat/Hello-World/branches/master/protection/required_status_checks",
                                                                                                              "strict": true,
                                                                                                              "contexts": [
                                                                                                                "continuous-integration/travis-ci"
                                                                                                              ],
                                                                                                              "contexts_url": "https://api.github.com/repos/octocat/Hello-World/branches/master/protection/required_status_checks/contexts"
                                                                                                            },
                                                                                                            "enforce_admins": {
                                                                                                              "url": "https://api.github.com/repos/octocat/Hello-World/branches/master/protection/enforce_admins",
                                                                                                              "enabled": true
                                                                                                            },
                                                                                                            "required_pull_request_reviews": {
                                                                                                              "url": "https://api.github.com/repos/octocat/Hello-World/branches/master/protection/required_pull_request_reviews",
                                                                                                              "dismissal_restrictions": {
                                                                                                                "url": "https://api.github.com/repos/octocat/Hello-World/branches/master/protection/dismissal_restrictions",
                                                                                                                "users_url": "https://api.github.com/repos/octocat/Hello-World/branches/master/protection/dismissal_restrictions/users",
                                                                                                                "teams_url": "https://api.github.com/repos/octocat/Hello-World/branches/master/protection/dismissal_restrictions/teams",
                                                                                                                "users": [
                                                                                                                  {
                                                                                                                    "login": "octocat",
                                                                                                                    "id": 1,
                                                                                                                    "avatar_url": "https://github.com/images/error/octocat_happy.gif",
                                                                                                                    "gravatar_id": "",
                                                                                                                    "url": "https://api.github.com/users/octocat",
                                                                                                                    "html_url": "https://github.com/octocat",
                                                                                                                    "followers_url": "https://api.github.com/users/octocat/followers",
                                                                                                                    "following_url": "https://api.github.com/users/octocat/following{/other_user}",
                                                                                                                    "gists_url": "https://api.github.com/users/octocat/gists{/gist_id}",
                                                                                                                    "starred_url": "https://api.github.com/users/octocat/starred{/owner}{/repo}",
                                                                                                                    "subscriptions_url": "https://api.github.com/users/octocat/subscriptions",
                                                                                                                    "organizations_url": "https://api.github.com/users/octocat/orgs",
                                                                                                                    "repos_url": "https://api.github.com/users/octocat/repos",
                                                                                                                    "events_url": "https://api.github.com/users/octocat/events{/privacy}",
                                                                                                                    "received_events_url": "https://api.github.com/users/octocat/received_events",
                                                                                                                    "type": "User",
                                                                                                                    "site_admin": false
                                                                                                                  }
                                                                                                                ],
                                                                                                                "teams": [
                                                                                                                  {
                                                                                                                    "id": 1,
                                                                                                                    "url": "https://api.github.com/teams/1",
                                                                                                                    "name": "Justice League",
                                                                                                                    "slug": "justice-league",
                                                                                                                    "description": "A great team.",
                                                                                                                    "privacy": "closed",
                                                                                                                    "permission": "admin",
                                                                                                                    "members_url": "https://api.github.com/teams/1/members{/member}",
                                                                                                                    "repositories_url": "https://api.github.com/teams/1/repos"
                                                                                                                  }
                                                                                                                ]
                                                                                                              },
                                                                                                              "dismiss_stale_reviews": true,
                                                                                                              "require_code_owner_reviews": true
                                                                                                            },
                                                                                                            "restrictions": {
                                                                                                              "url": "https://api.github.com/repos/octocat/Hello-World/branches/master/protection/restrictions",
                                                                                                              "users_url": "https://api.github.com/repos/octocat/Hello-World/branches/master/protection/restrictions/users",
                                                                                                              "teams_url": "https://api.github.com/repos/octocat/Hello-World/branches/master/protection/restrictions/teams",
                                                                                                              "users": [
                                                                                                                {
                                                                                                                  "login": "octocat",
                                                                                                                  "id": 1,
                                                                                                                  "avatar_url": "https://github.com/images/error/octocat_happy.gif",
                                                                                                                  "gravatar_id": "",
                                                                                                                  "url": "https://api.github.com/users/octocat",
                                                                                                                  "html_url": "https://github.com/octocat",
                                                                                                                  "followers_url": "https://api.github.com/users/octocat/followers",
                                                                                                                  "following_url": "https://api.github.com/users/octocat/following{/other_user}",
                                                                                                                  "gists_url": "https://api.github.com/users/octocat/gists{/gist_id}",
                                                                                                                  "starred_url": "https://api.github.com/users/octocat/starred{/owner}{/repo}",
                                                                                                                  "subscriptions_url": "https://api.github.com/users/octocat/subscriptions",
                                                                                                                  "organizations_url": "https://api.github.com/users/octocat/orgs",
                                                                                                                  "repos_url": "https://api.github.com/users/octocat/repos",
                                                                                                                  "events_url": "https://api.github.com/users/octocat/events{/privacy}",
                                                                                                                  "received_events_url": "https://api.github.com/users/octocat/received_events",
                                                                                                                  "type": "User",
                                                                                                                  "site_admin": false
                                                                                                                }
                                                                                                              ],
                                                                                                              "teams": [
                                                                                                                {
                                                                                                                  "id": 1,
                                                                                                                  "url": "https://api.github.com/teams/1",
                                                                                                                  "name": "Justice League",
                                                                                                                  "slug": "justice-league",
                                                                                                                  "description": "A great team.",
                                                                                                                  "privacy": "closed",
                                                                                                                  "permission": "admin",
                                                                                                                  "members_url": "https://api.github.com/teams/1/members{/member}",
                                                                                                                  "repositories_url": "https://api.github.com/teams/1/repos"
                                                                                                                }
                                                                                                              ]
                                                                                                            }
                                                                                                          }
                                                                                                          

                                                                                                          Update branch protection

                                                                                                          Protecting a branch requires admin access.

                                                                                                          PUT /repos/:owner/:repo/branches/:branch/protection
                                                                                                          

                                                                                                          Parameters

                                                                                                          Name Type Description
                                                                                                          required_status_checks object Required. Require status checks to pass before merging. Set to null to disable.
                                                                                                          enforce_admins boolean Required. Enforce all configured restrictions for administrators. Set to true to enforce required status checks for repository administrators. Set to null to disable.
                                                                                                          required_pull_request_reviews object Required. Require at least one approving review on a pull request, before merging. Set to null to disable.
                                                                                                          restrictions object Required. Restrict who can push to this branch. Team and user restrictions are only available for organization-owned repositories. Set to null to disable.

                                                                                                          The required_status_checks object must have the following keys:

                                                                                                          Name Type Description
                                                                                                          strict boolean Required. Require branches to be up to date before merging.
                                                                                                          contexts array Required. The list of status checks to require in order to merge into this branch

                                                                                                          The required_pull_request_reviews object must have the following keys:

                                                                                                          Name Type Description
                                                                                                          dismissal_restrictions object Specify which users and teams can dismiss pull request reviews. Pass an empty dismissal_restrictions object to disable. User and team dismissal_restrictions are only available for organization-owned repositories. Omit this parameter for personal repositories.
                                                                                                          dismiss_stale_reviews boolean Dismiss approved reviews automatically when a new commit is pushed.
                                                                                                          require_code_owner_reviews boolean Blocks merge until code owners have reviewed.

                                                                                                          The dismissal_restrictions object must have the following keys:

                                                                                                          Name Type Description
                                                                                                          users array The list of user logins with dismissal access
                                                                                                          teams array The list of team slugs with dismissal access

                                                                                                          Note: Passing new arrays of users and teams replaces their previous values.

                                                                                                          The restrictions object must have the following keys:

                                                                                                          Name Type Description
                                                                                                          users array The list of user logins with push access
                                                                                                          teams array The list of team slugs with push access

                                                                                                          Note: The list of users and teams in total is limited to 100 items.

                                                                                                          Example

                                                                                                          {
                                                                                                            "required_status_checks": {
                                                                                                              "strict": true,
                                                                                                              "contexts": [
                                                                                                                "continuous-integration/travis-ci"
                                                                                                              ]
                                                                                                            },
                                                                                                            "enforce_admins": true,
                                                                                                            "required_pull_request_reviews": {
                                                                                                              "dismissal_restrictions": {
                                                                                                                "users": [
                                                                                                                  "octocat"
                                                                                                                ],
                                                                                                                "teams": [
                                                                                                                  "justice-league"
                                                                                                                ]
                                                                                                              },
                                                                                                              "dismiss_stale_reviews": true,
                                                                                                              "require_code_owner_reviews": true
                                                                                                            },
                                                                                                            "restrictions": {
                                                                                                              "users": [
                                                                                                                "octocat"
                                                                                                              ],
                                                                                                              "teams": [
                                                                                                                "justice-league"
                                                                                                              ]
                                                                                                            }
                                                                                                          }
                                                                                                          

                                                                                                          Response

                                                                                                          Status: 200 OK
                                                                                                          
                                                                                                          {
                                                                                                            "url": "https://api.github.com/repos/octocat/Hello-World/branches/master/protection",
                                                                                                            "required_status_checks": {
                                                                                                              "url": "https://api.github.com/repos/octocat/Hello-World/branches/master/protection/required_status_checks",
                                                                                                              "strict": true,
                                                                                                              "contexts": [
                                                                                                                "continuous-integration/travis-ci"
                                                                                                              ],
                                                                                                              "contexts_url": "https://api.github.com/repos/octocat/Hello-World/branches/master/protection/required_status_checks/contexts"
                                                                                                            },
                                                                                                            "enforce_admins": {
                                                                                                              "url": "https://api.github.com/repos/octocat/Hello-World/branches/master/protection/enforce_admins",
                                                                                                              "enabled": true
                                                                                                            },
                                                                                                            "required_pull_request_reviews": {
                                                                                                              "url": "https://api.github.com/repos/octocat/Hello-World/branches/master/protection/required_pull_request_reviews",
                                                                                                              "dismissal_restrictions": {
                                                                                                                "url": "https://api.github.com/repos/octocat/Hello-World/branches/master/protection/dismissal_restrictions",
                                                                                                                "users_url": "https://api.github.com/repos/octocat/Hello-World/branches/master/protection/dismissal_restrictions/users",
                                                                                                                "teams_url": "https://api.github.com/repos/octocat/Hello-World/branches/master/protection/dismissal_restrictions/teams",
                                                                                                                "users": [
                                                                                                                  {
                                                                                                                    "login": "octocat",
                                                                                                                    "id": 1,
                                                                                                                    "avatar_url": "https://github.com/images/error/octocat_happy.gif",
                                                                                                                    "gravatar_id": "",
                                                                                                                    "url": "https://api.github.com/users/octocat",
                                                                                                                    "html_url": "https://github.com/octocat",
                                                                                                                    "followers_url": "https://api.github.com/users/octocat/followers",
                                                                                                                    "following_url": "https://api.github.com/users/octocat/following{/other_user}",
                                                                                                                    "gists_url": "https://api.github.com/users/octocat/gists{/gist_id}",
                                                                                                                    "starred_url": "https://api.github.com/users/octocat/starred{/owner}{/repo}",
                                                                                                                    "subscriptions_url": "https://api.github.com/users/octocat/subscriptions",
                                                                                                                    "organizations_url": "https://api.github.com/users/octocat/orgs",
                                                                                                                    "repos_url": "https://api.github.com/users/octocat/repos",
                                                                                                                    "events_url": "https://api.github.com/users/octocat/events{/privacy}",
                                                                                                                    "received_events_url": "https://api.github.com/users/octocat/received_events",
                                                                                                                    "type": "User",
                                                                                                                    "site_admin": false
                                                                                                                  }
                                                                                                                ],
                                                                                                                "teams": [
                                                                                                                  {
                                                                                                                    "id": 1,
                                                                                                                    "url": "https://api.github.com/teams/1",
                                                                                                                    "name": "Justice League",
                                                                                                                    "slug": "justice-league",
                                                                                                                    "description": "A great team.",
                                                                                                                    "privacy": "closed",
                                                                                                                    "permission": "admin",
                                                                                                                    "members_url": "https://api.github.com/teams/1/members{/member}",
                                                                                                                    "repositories_url": "https://api.github.com/teams/1/repos"
                                                                                                                  }
                                                                                                                ]
                                                                                                              },
                                                                                                              "dismiss_stale_reviews": true,
                                                                                                              "require_code_owner_reviews": true
                                                                                                            },
                                                                                                            "restrictions": {
                                                                                                              "url": "https://api.github.com/repos/octocat/Hello-World/branches/master/protection/restrictions",
                                                                                                              "users_url": "https://api.github.com/repos/octocat/Hello-World/branches/master/protection/restrictions/users",
                                                                                                              "teams_url": "https://api.github.com/repos/octocat/Hello-World/branches/master/protection/restrictions/teams",
                                                                                                              "users": [
                                                                                                                {
                                                                                                                  "login": "octocat",
                                                                                                                  "id": 1,
                                                                                                                  "avatar_url": "https://github.com/images/error/octocat_happy.gif",
                                                                                                                  "gravatar_id": "",
                                                                                                                  "url": "https://api.github.com/users/octocat",
                                                                                                                  "html_url": "https://github.com/octocat",
                                                                                                                  "followers_url": "https://api.github.com/users/octocat/followers",
                                                                                                                  "following_url": "https://api.github.com/users/octocat/following{/other_user}",
                                                                                                                  "gists_url": "https://api.github.com/users/octocat/gists{/gist_id}",
                                                                                                                  "starred_url": "https://api.github.com/users/octocat/starred{/owner}{/repo}",
                                                                                                                  "subscriptions_url": "https://api.github.com/users/octocat/subscriptions",
                                                                                                                  "organizations_url": "https://api.github.com/users/octocat/orgs",
                                                                                                                  "repos_url": "https://api.github.com/users/octocat/repos",
                                                                                                                  "events_url": "https://api.github.com/users/octocat/events{/privacy}",
                                                                                                                  "received_events_url": "https://api.github.com/users/octocat/received_events",
                                                                                                                  "type": "User",
                                                                                                                  "site_admin": false
                                                                                                                }
                                                                                                              ],
                                                                                                              "teams": [
                                                                                                                {
                                                                                                                  "id": 1,
                                                                                                                  "url": "https://api.github.com/teams/1",
                                                                                                                  "name": "Justice League",
                                                                                                                  "slug": "justice-league",
                                                                                                                  "description": "A great team.",
                                                                                                                  "privacy": "closed",
                                                                                                                  "permission": "admin",
                                                                                                                  "members_url": "https://api.github.com/teams/1/members{/member}",
                                                                                                                  "repositories_url": "https://api.github.com/teams/1/repos"
                                                                                                                }
                                                                                                              ]
                                                                                                            }
                                                                                                          }
                                                                                                          

                                                                                                          Remove branch protection

                                                                                                          DELETE /repos/:owner/:repo/branches/:branch/protection
                                                                                                          
                                                                                                          Status: 204 No Content
                                                                                                          

                                                                                                          Get required status checks of protected branch

                                                                                                          GET /repos/:owner/:repo/branches/:branch/protection/required_status_checks
                                                                                                          
                                                                                                          Status: 200 OK
                                                                                                          
                                                                                                          {
                                                                                                            "url": "https://api.github.com/repos/octocat/Hello-World/branches/master/protection/required_status_checks",
                                                                                                            "strict": true,
                                                                                                            "contexts": [
                                                                                                              "continuous-integration/travis-ci"
                                                                                                            ],
                                                                                                            "contexts_url": "https://api.github.com/repos/octocat/Hello-World/branches/master/protection/required_status_checks/contexts"
                                                                                                          }
                                                                                                          

                                                                                                          Update required status checks of protected branch

                                                                                                          Updating required status checks requires admin access and branch protection to be enabled.

                                                                                                          PATCH /repos/:owner/:repo/branches/:branch/protection/required_status_checks
                                                                                                          

                                                                                                          Parameters

                                                                                                          The object passed can have the following keys:

                                                                                                          Name Type Description
                                                                                                          strict boolean Require branches to be up to date before merging.
                                                                                                          contexts array The list of status checks to require in order to merge into this branch

                                                                                                          Example

                                                                                                          {
                                                                                                            "strict": true,
                                                                                                            "contexts": [
                                                                                                              "continuous-integration/travis-ci"
                                                                                                            ]
                                                                                                          }
                                                                                                          

                                                                                                          Response

                                                                                                          Status: 200 OK
                                                                                                          
                                                                                                          {
                                                                                                            "url": "https://api.github.com/repos/octocat/Hello-World/branches/master/protection/required_status_checks",
                                                                                                            "strict": true,
                                                                                                            "contexts": [
                                                                                                              "continuous-integration/travis-ci"
                                                                                                            ],
                                                                                                            "contexts_url": "https://api.github.com/repos/octocat/Hello-World/branches/master/protection/required_status_checks/contexts"
                                                                                                          }
                                                                                                          

                                                                                                          Remove required status checks of protected branch

                                                                                                          DELETE /repos/:owner/:repo/branches/:branch/protection/required_status_checks
                                                                                                          
                                                                                                          Status: 204 No Content
                                                                                                          

                                                                                                          List required status checks contexts of protected branch

                                                                                                          GET /repos/:owner/:repo/branches/:branch/protection/required_status_checks/contexts
                                                                                                          
                                                                                                          Status: 200 OK
                                                                                                          
                                                                                                          [
                                                                                                            "continuous-integration/travis-ci"
                                                                                                          ]
                                                                                                          

                                                                                                          Replace required status checks contexts of protected branch

                                                                                                          PUT /repos/:owner/:repo/branches/:branch/protection/required_status_checks/contexts
                                                                                                          

                                                                                                          Example

                                                                                                          [
                                                                                                            "continuous-integration/travis-ci"
                                                                                                          ]
                                                                                                          

                                                                                                          Response

                                                                                                          Status: 200 OK
                                                                                                          
                                                                                                          [
                                                                                                            "continuous-integration/travis-ci"
                                                                                                          ]
                                                                                                          

                                                                                                          Add required status checks contexts of protected branch

                                                                                                          POST /repos/:owner/:repo/branches/:branch/protection/required_status_checks/contexts
                                                                                                          

                                                                                                          Example

                                                                                                          [
                                                                                                            "continuous-integration/jenkins"
                                                                                                          ]
                                                                                                          

                                                                                                          Response

                                                                                                          Status: 200 OK
                                                                                                          
                                                                                                          [
                                                                                                            "continuous-integration/travis-ci",
                                                                                                            "continuous-integration/jenkins"
                                                                                                          ]
                                                                                                          

                                                                                                          Remove required status checks contexts of protected branch

                                                                                                          DELETE /repos/:owner/:repo/branches/:branch/protection/required_status_checks/contexts
                                                                                                          

                                                                                                          Example

                                                                                                          [
                                                                                                            "continuous-integration/jenkins"
                                                                                                          ]
                                                                                                          

                                                                                                          Response

                                                                                                          Status: 200 OK
                                                                                                          
                                                                                                          [
                                                                                                            "continuous-integration/travis-ci"
                                                                                                          ]
                                                                                                          

                                                                                                          Get pull request review enforcement of protected branch

                                                                                                          GET /repos/:owner/:repo/branches/:branch/protection/required_pull_request_reviews
                                                                                                          
                                                                                                          Status: 200 OK
                                                                                                          
                                                                                                          {
                                                                                                            "url": "https://api.github.com/repos/octocat/Hello-World/branches/master/protection/required_pull_request_reviews",
                                                                                                            "dismissal_restrictions": {
                                                                                                              "url": "https://api.github.com/repos/octocat/Hello-World/branches/master/protection/dismissal_restrictions",
                                                                                                              "users_url": "https://api.github.com/repos/octocat/Hello-World/branches/master/protection/dismissal_restrictions/users",
                                                                                                              "teams_url": "https://api.github.com/repos/octocat/Hello-World/branches/master/protection/dismissal_restrictions/teams",
                                                                                                              "users": [
                                                                                                                {
                                                                                                                  "login": "octocat",
                                                                                                                  "id": 1,
                                                                                                                  "avatar_url": "https://github.com/images/error/octocat_happy.gif",
                                                                                                                  "gravatar_id": "",
                                                                                                                  "url": "https://api.github.com/users/octocat",
                                                                                                                  "html_url": "https://github.com/octocat",
                                                                                                                  "followers_url": "https://api.github.com/users/octocat/followers",
                                                                                                                  "following_url": "https://api.github.com/users/octocat/following{/other_user}",
                                                                                                                  "gists_url": "https://api.github.com/users/octocat/gists{/gist_id}",
                                                                                                                  "starred_url": "https://api.github.com/users/octocat/starred{/owner}{/repo}",
                                                                                                                  "subscriptions_url": "https://api.github.com/users/octocat/subscriptions",
                                                                                                                  "organizations_url": "https://api.github.com/users/octocat/orgs",
                                                                                                                  "repos_url": "https://api.github.com/users/octocat/repos",
                                                                                                                  "events_url": "https://api.github.com/users/octocat/events{/privacy}",
                                                                                                                  "received_events_url": "https://api.github.com/users/octocat/received_events",
                                                                                                                  "type": "User",
                                                                                                                  "site_admin": false
                                                                                                                }
                                                                                                              ],
                                                                                                              "teams": [
                                                                                                                {
                                                                                                                  "id": 1,
                                                                                                                  "url": "https://api.github.com/teams/1",
                                                                                                                  "name": "Justice League",
                                                                                                                  "slug": "justice-league",
                                                                                                                  "description": "A great team.",
                                                                                                                  "privacy": "closed",
                                                                                                                  "permission": "admin",
                                                                                                                  "members_url": "https://api.github.com/teams/1/members{/member}",
                                                                                                                  "repositories_url": "https://api.github.com/teams/1/repos"
                                                                                                                }
                                                                                                              ]
                                                                                                            },
                                                                                                            "dismiss_stale_reviews": true,
                                                                                                            "require_code_owner_reviews": true
                                                                                                          }
                                                                                                          

                                                                                                          Update pull request review enforcement of protected branch

                                                                                                          Updating pull request review enforcement requires admin access and branch protection to be enabled.

                                                                                                          PATCH /repos/:owner/:repo/branches/:branch/protection/required_pull_request_reviews
                                                                                                          

                                                                                                          Parameters

                                                                                                          The object passed can have the following keys:

                                                                                                          Name Type Description
                                                                                                          dismissal_restrictions object Specify which users and teams can dismiss pull request reviews. User and team dismissal_restrictions are only available for organization-owned repositories. Omit this parameter for personal repositories.
                                                                                                          dismiss_stale_reviews boolean Dismiss approved reviews automatically when a new commit is pushed.
                                                                                                          require_code_owner_reviews boolean Blocks merge until code owners have reviewed.

                                                                                                          The dismissal_restrictions object must have the following keys:

                                                                                                          Name Type Description
                                                                                                          users array The list of user logins with dismissal access
                                                                                                          teams array The list of team slugs with dismissal access

                                                                                                          Note: Passing new arrays of users and teams replaces their previous values.

                                                                                                          Example

                                                                                                          {
                                                                                                            "dismissal_restrictions": {
                                                                                                              "users": [
                                                                                                                "octocat"
                                                                                                              ],
                                                                                                              "teams": [
                                                                                                                "justice-league"
                                                                                                              ]
                                                                                                            },
                                                                                                            "dismiss_stale_reviews": true,
                                                                                                            "require_code_owner_reviews": true
                                                                                                          }
                                                                                                          

                                                                                                          Response

                                                                                                          Status: 200 OK
                                                                                                          
                                                                                                          {
                                                                                                            "url": "https://api.github.com/repos/octocat/Hello-World/branches/master/protection/required_pull_request_reviews",
                                                                                                            "dismissal_restrictions": {
                                                                                                              "url": "https://api.github.com/repos/octocat/Hello-World/branches/master/protection/dismissal_restrictions",
                                                                                                              "users_url": "https://api.github.com/repos/octocat/Hello-World/branches/master/protection/dismissal_restrictions/users",
                                                                                                              "teams_url": "https://api.github.com/repos/octocat/Hello-World/branches/master/protection/dismissal_restrictions/teams",
                                                                                                              "users": [
                                                                                                                {
                                                                                                                  "login": "octocat",
                                                                                                                  "id": 1,
                                                                                                                  "avatar_url": "https://github.com/images/error/octocat_happy.gif",
                                                                                                                  "gravatar_id": "",
                                                                                                                  "url": "https://api.github.com/users/octocat",
                                                                                                                  "html_url": "https://github.com/octocat",
                                                                                                                  "followers_url": "https://api.github.com/users/octocat/followers",
                                                                                                                  "following_url": "https://api.github.com/users/octocat/following{/other_user}",
                                                                                                                  "gists_url": "https://api.github.com/users/octocat/gists{/gist_id}",
                                                                                                                  "starred_url": "https://api.github.com/users/octocat/starred{/owner}{/repo}",
                                                                                                                  "subscriptions_url": "https://api.github.com/users/octocat/subscriptions",
                                                                                                                  "organizations_url": "https://api.github.com/users/octocat/orgs",
                                                                                                                  "repos_url": "https://api.github.com/users/octocat/repos",
                                                                                                                  "events_url": "https://api.github.com/users/octocat/events{/privacy}",
                                                                                                                  "received_events_url": "https://api.github.com/users/octocat/received_events",
                                                                                                                  "type": "User",
                                                                                                                  "site_admin": false
                                                                                                                }
                                                                                                              ],
                                                                                                              "teams": [
                                                                                                                {
                                                                                                                  "id": 1,
                                                                                                                  "url": "https://api.github.com/teams/1",
                                                                                                                  "name": "Justice League",
                                                                                                                  "slug": "justice-league",
                                                                                                                  "description": "A great team.",
                                                                                                                  "privacy": "closed",
                                                                                                                  "permission": "admin",
                                                                                                                  "members_url": "https://api.github.com/teams/1/members{/member}",
                                                                                                                  "repositories_url": "https://api.github.com/teams/1/repos"
                                                                                                                }
                                                                                                              ]
                                                                                                            },
                                                                                                            "dismiss_stale_reviews": true,
                                                                                                            "require_code_owner_reviews": true
                                                                                                          }
                                                                                                          

                                                                                                          Remove pull request review enforcement of protected branch

                                                                                                          DELETE /repos/:owner/:repo/branches/:branch/protection/required_pull_request_reviews
                                                                                                          
                                                                                                          Status: 204 No Content
                                                                                                          

                                                                                                          Get admin enforcement of protected branch

                                                                                                          GET /repos/:owner/:repo/branches/:branch/protection/enforce_admins
                                                                                                          
                                                                                                          Status: 200 OK
                                                                                                          
                                                                                                          {
                                                                                                            "url": "https://api.github.com/repos/octocat/Hello-World/branches/master/protection/enforce_admins",
                                                                                                            "enabled": true
                                                                                                          }
                                                                                                          

                                                                                                          Add admin enforcement of protected branch

                                                                                                          Adding admin enforcement requires admin access and branch protection to be enabled.

                                                                                                          POST /repos/:owner/:repo/branches/:branch/protection/enforce_admins
                                                                                                          

                                                                                                          Response

                                                                                                          Status: 200 OK
                                                                                                          
                                                                                                          {
                                                                                                            "url": "https://api.github.com/repos/octocat/Hello-World/branches/master/protection/enforce_admins",
                                                                                                            "enabled": true
                                                                                                          }
                                                                                                          

                                                                                                          Remove admin enforcement of protected branch

                                                                                                          Removing admin enforcement requires admin access and branch protection to be enabled.

                                                                                                          DELETE /repos/:owner/:repo/branches/:branch/protection/enforce_admins
                                                                                                          
                                                                                                          Status: 204 No Content
                                                                                                          

                                                                                                          Get restrictions of protected branch

                                                                                                          Note: Teams and users restrictions are only available for organization-owned repositories.

                                                                                                          GET /repos/:owner/:repo/branches/:branch/protection/restrictions
                                                                                                          
                                                                                                          Status: 200 OK
                                                                                                          
                                                                                                          {
                                                                                                            "url": "https://api.github.com/repos/octocat/Hello-World/branches/master/protection/restrictions",
                                                                                                            "users_url": "https://api.github.com/repos/octocat/Hello-World/branches/master/protection/restrictions/users",
                                                                                                            "teams_url": "https://api.github.com/repos/octocat/Hello-World/branches/master/protection/restrictions/teams",
                                                                                                            "users": [
                                                                                                              {
                                                                                                                "login": "octocat",
                                                                                                                "id": 1,
                                                                                                                "avatar_url": "https://github.com/images/error/octocat_happy.gif",
                                                                                                                "gravatar_id": "",
                                                                                                                "url": "https://api.github.com/users/octocat",
                                                                                                                "html_url": "https://github.com/octocat",
                                                                                                                "followers_url": "https://api.github.com/users/octocat/followers",
                                                                                                                "following_url": "https://api.github.com/users/octocat/following{/other_user}",
                                                                                                                "gists_url": "https://api.github.com/users/octocat/gists{/gist_id}",
                                                                                                                "starred_url": "https://api.github.com/users/octocat/starred{/owner}{/repo}",
                                                                                                                "subscriptions_url": "https://api.github.com/users/octocat/subscriptions",
                                                                                                                "organizations_url": "https://api.github.com/users/octocat/orgs",
                                                                                                                "repos_url": "https://api.github.com/users/octocat/repos",
                                                                                                                "events_url": "https://api.github.com/users/octocat/events{/privacy}",
                                                                                                                "received_events_url": "https://api.github.com/users/octocat/received_events",
                                                                                                                "type": "User",
                                                                                                                "site_admin": false
                                                                                                              }
                                                                                                            ],
                                                                                                            "teams": [
                                                                                                              {
                                                                                                                "id": 1,
                                                                                                                "url": "https://api.github.com/teams/1",
                                                                                                                "name": "Justice League",
                                                                                                                "slug": "justice-league",
                                                                                                                "description": "A great team.",
                                                                                                                "privacy": "closed",
                                                                                                                "permission": "admin",
                                                                                                                "members_url": "https://api.github.com/teams/1/members{/member}",
                                                                                                                "repositories_url": "https://api.github.com/teams/1/repos"
                                                                                                              }
                                                                                                            ]
                                                                                                          }
                                                                                                          

                                                                                                          Remove restrictions of protected branch

                                                                                                          DELETE /repos/:owner/:repo/branches/:branch/protection/restrictions
                                                                                                          
                                                                                                          Status: 204 No Content
                                                                                                          

                                                                                                          List team restrictions of protected branch

                                                                                                          Note: The Nested Teams API is currently available for developers to preview. See the blog post for full details. To access the API, you must provide a custom media type in the Accept header:

                                                                                                          application/vnd.github.hellcat-preview+json
                                                                                                          

                                                                                                          Warning: The API may change without advance notice during the preview period. Preview features are not supported for production use. If you experience any issues, contact GitHub support.

                                                                                                          GET /repos/:owner/:repo/branches/:branch/protection/restrictions/teams
                                                                                                          
                                                                                                          Status: 200 OK
                                                                                                          
                                                                                                          [
                                                                                                            {
                                                                                                              "id": 1,
                                                                                                              "url": "https://api.github.com/teams/1",
                                                                                                              "name": "Justice League",
                                                                                                              "slug": "justice-league",
                                                                                                              "description": "A great team.",
                                                                                                              "privacy": "closed",
                                                                                                              "permission": "admin",
                                                                                                              "members_url": "https://api.github.com/teams/1/members{/member}",
                                                                                                              "repositories_url": "https://api.github.com/teams/1/repos",
                                                                                                              "parent": null
                                                                                                            }
                                                                                                          ]
                                                                                                          

                                                                                                          Replace team restrictions of protected branch

                                                                                                          Note: The Nested Teams API is currently available for developers to preview. See the blog post for full details. To access the API, you must provide a custom media type in the Accept header:

                                                                                                          application/vnd.github.hellcat-preview+json
                                                                                                          

                                                                                                          Warning: The API may change without advance notice during the preview period. Preview features are not supported for production use. If you experience any issues, contact GitHub support.

                                                                                                          PUT /repos/:owner/:repo/branches/:branch/protection/restrictions/teams
                                                                                                          

                                                                                                          Body parameters

                                                                                                          Pass the list of team slugs with push access.

                                                                                                          Note: The list of users and teams in total is limited to 100 items.

                                                                                                          Example

                                                                                                          [
                                                                                                            "justice-league"
                                                                                                          ]
                                                                                                          

                                                                                                          Response

                                                                                                          Status: 200 OK
                                                                                                          
                                                                                                          [
                                                                                                            {
                                                                                                              "id": 1,
                                                                                                              "url": "https://api.github.com/teams/1",
                                                                                                              "name": "Justice League",
                                                                                                              "slug": "justice-league",
                                                                                                              "description": "A great team.",
                                                                                                              "privacy": "closed",
                                                                                                              "permission": "admin",
                                                                                                              "members_url": "https://api.github.com/teams/1/members{/member}",
                                                                                                              "repositories_url": "https://api.github.com/teams/1/repos",
                                                                                                              "parent": null
                                                                                                            }
                                                                                                          ]
                                                                                                          

                                                                                                          Add team restrictions of protected branch

                                                                                                          Note: The Nested Teams API is currently available for developers to preview. See the blog post for full details. To access the API, you must provide a custom media type in the Accept header:

                                                                                                          application/vnd.github.hellcat-preview+json
                                                                                                          

                                                                                                          Warning: The API may change without advance notice during the preview period. Preview features are not supported for production use. If you experience any issues, contact GitHub support.

                                                                                                          POST /repos/:owner/:repo/branches/:branch/protection/restrictions/teams
                                                                                                          

                                                                                                          Body parameters

                                                                                                          Pass the list of team slugs with push access.

                                                                                                          Note: The list of users and teams in total is limited to 100 items.

                                                                                                          Example

                                                                                                          [
                                                                                                            "justice-league"
                                                                                                          ]
                                                                                                          

                                                                                                          Response

                                                                                                          Status: 200 OK
                                                                                                          
                                                                                                          [
                                                                                                            {
                                                                                                              "id": 1,
                                                                                                              "url": "https://api.github.com/teams/1",
                                                                                                              "name": "Justice League",
                                                                                                              "slug": "justice-league",
                                                                                                              "description": "A great team.",
                                                                                                              "privacy": "closed",
                                                                                                              "permission": "admin",
                                                                                                              "members_url": "https://api.github.com/teams/1/members{/member}",
                                                                                                              "repositories_url": "https://api.github.com/teams/1/repos",
                                                                                                              "parent": null
                                                                                                            }
                                                                                                          ]
                                                                                                          

                                                                                                          Remove team restrictions of protected branch

                                                                                                          Note: The Nested Teams API is currently available for developers to preview. See the blog post for full details. To access the API, you must provide a custom media type in the Accept header:

                                                                                                          application/vnd.github.hellcat-preview+json
                                                                                                          

                                                                                                          Warning: The API may change without advance notice during the preview period. Preview features are not supported for production use. If you experience any issues, contact GitHub support.

                                                                                                          DELETE /repos/:owner/:repo/branches/:branch/protection/restrictions/teams
                                                                                                          

                                                                                                          Example

                                                                                                          [
                                                                                                            "octocats"
                                                                                                          ]
                                                                                                          

                                                                                                          Response

                                                                                                          Status: 200 OK
                                                                                                          
                                                                                                          [
                                                                                                            {
                                                                                                              "id": 1,
                                                                                                              "url": "https://api.github.com/teams/1",
                                                                                                              "name": "Justice League",
                                                                                                              "slug": "justice-league",
                                                                                                              "description": "A great team.",
                                                                                                              "privacy": "closed",
                                                                                                              "permission": "admin",
                                                                                                              "members_url": "https://api.github.com/teams/1/members{/member}",
                                                                                                              "repositories_url": "https://api.github.com/teams/1/repos",
                                                                                                              "parent": null
                                                                                                            }
                                                                                                          ]
                                                                                                          

                                                                                                          List user restrictions of protected branch

                                                                                                          GET /repos/:owner/:repo/branches/:branch/protection/restrictions/users
                                                                                                          
                                                                                                          Status: 200 OK
                                                                                                          
                                                                                                          [
                                                                                                            {
                                                                                                              "login": "octocat",
                                                                                                              "id": 1,
                                                                                                              "avatar_url": "https://github.com/images/error/octocat_happy.gif",
                                                                                                              "gravatar_id": "",
                                                                                                              "url": "https://api.github.com/users/octocat",
                                                                                                              "html_url": "https://github.com/octocat",
                                                                                                              "followers_url": "https://api.github.com/users/octocat/followers",
                                                                                                              "following_url": "https://api.github.com/users/octocat/following{/other_user}",
                                                                                                              "gists_url": "https://api.github.com/users/octocat/gists{/gist_id}",
                                                                                                              "starred_url": "https://api.github.com/users/octocat/starred{/owner}{/repo}",
                                                                                                              "subscriptions_url": "https://api.github.com/users/octocat/subscriptions",
                                                                                                              "organizations_url": "https://api.github.com/users/octocat/orgs",
                                                                                                              "repos_url": "https://api.github.com/users/octocat/repos",
                                                                                                              "events_url": "https://api.github.com/users/octocat/events{/privacy}",
                                                                                                              "received_events_url": "https://api.github.com/users/octocat/received_events",
                                                                                                              "type": "User",
                                                                                                              "site_admin": false
                                                                                                            }
                                                                                                          ]
                                                                                                          

                                                                                                          Replace user restrictions of protected branch

                                                                                                          PUT /repos/:owner/:repo/branches/:branch/protection/restrictions/users
                                                                                                          

                                                                                                          Body parameters

                                                                                                          Pass the list of user logins with push access.

                                                                                                          Note: The list of users and teams in total is limited to 100 items.

                                                                                                          Example

                                                                                                          [
                                                                                                            "octocat"
                                                                                                          ]
                                                                                                          

                                                                                                          Response

                                                                                                          Status: 200 OK
                                                                                                          
                                                                                                          [
                                                                                                            {
                                                                                                              "login": "octocat",
                                                                                                              "id": 1,
                                                                                                              "avatar_url": "https://github.com/images/error/octocat_happy.gif",
                                                                                                              "gravatar_id": "",
                                                                                                              "url": "https://api.github.com/users/octocat",
                                                                                                              "html_url": "https://github.com/octocat",
                                                                                                              "followers_url": "https://api.github.com/users/octocat/followers",
                                                                                                              "following_url": "https://api.github.com/users/octocat/following{/other_user}",
                                                                                                              "gists_url": "https://api.github.com/users/octocat/gists{/gist_id}",
                                                                                                              "starred_url": "https://api.github.com/users/octocat/starred{/owner}{/repo}",
                                                                                                              "subscriptions_url": "https://api.github.com/users/octocat/subscriptions",
                                                                                                              "organizations_url": "https://api.github.com/users/octocat/orgs",
                                                                                                              "repos_url": "https://api.github.com/users/octocat/repos",
                                                                                                              "events_url": "https://api.github.com/users/octocat/events{/privacy}",
                                                                                                              "received_events_url": "https://api.github.com/users/octocat/received_events",
                                                                                                              "type": "User",
                                                                                                              "site_admin": false
                                                                                                            }
                                                                                                          ]
                                                                                                          

                                                                                                          Add user restrictions of protected branch

                                                                                                          POST /repos/:owner/:repo/branches/:branch/protection/restrictions/users
                                                                                                          

                                                                                                          Body parameters

                                                                                                          Pass the list of user logins with push access.

                                                                                                          Note: The list of users and teams in total is limited to 100 items.

                                                                                                          Example

                                                                                                          [
                                                                                                            "octocat"
                                                                                                          ]
                                                                                                          

                                                                                                          Response

                                                                                                          Status: 200 OK
                                                                                                          
                                                                                                          [
                                                                                                            {
                                                                                                              "login": "octocat",
                                                                                                              "id": 1,
                                                                                                              "avatar_url": "https://github.com/images/error/octocat_happy.gif",
                                                                                                              "gravatar_id": "",
                                                                                                              "url": "https://api.github.com/users/octocat",
                                                                                                              "html_url": "https://github.com/octocat",
                                                                                                              "followers_url": "https://api.github.com/users/octocat/followers",
                                                                                                              "following_url": "https://api.github.com/users/octocat/following{/other_user}",
                                                                                                              "gists_url": "https://api.github.com/users/octocat/gists{/gist_id}",
                                                                                                              "starred_url": "https://api.github.com/users/octocat/starred{/owner}{/repo}",
                                                                                                              "subscriptions_url": "https://api.github.com/users/octocat/subscriptions",
                                                                                                              "organizations_url": "https://api.github.com/users/octocat/orgs",
                                                                                                              "repos_url": "https://api.github.com/users/octocat/repos",
                                                                                                              "events_url": "https://api.github.com/users/octocat/events{/privacy}",
                                                                                                              "received_events_url": "https://api.github.com/users/octocat/received_events",
                                                                                                              "type": "User",
                                                                                                              "site_admin": false
                                                                                                            }
                                                                                                          ]
                                                                                                          

                                                                                                          Remove user restrictions of protected branch

                                                                                                          DELETE /repos/:owner/:repo/branches/:branch/protection/restrictions/users
                                                                                                          

                                                                                                          Example

                                                                                                          [
                                                                                                            "defunkt"
                                                                                                          ]
                                                                                                          

                                                                                                          Response

                                                                                                          Status: 200 OK
                                                                                                          
                                                                                                          [
                                                                                                            {
                                                                                                              "login": "octocat",
                                                                                                              "id": 1,
                                                                                                              "avatar_url": "https://github.com/images/error/octocat_happy.gif",
                                                                                                              "gravatar_id": "",
                                                                                                              "url": "https://api.github.com/users/octocat",
                                                                                                              "html_url": "https://github.com/octocat",
                                                                                                              "followers_url": "https://api.github.com/users/octocat/followers",
                                                                                                              "following_url": "https://api.github.com/users/octocat/following{/other_user}",
                                                                                                              "gists_url": "https://api.github.com/users/octocat/gists{/gist_id}",
                                                                                                              "starred_url": "https://api.github.com/users/octocat/starred{/owner}{/repo}",
                                                                                                              "subscriptions_url": "https://api.github.com/users/octocat/subscriptions",
                                                                                                              "organizations_url": "https://api.github.com/users/octocat/orgs",
                                                                                                              "repos_url": "https://api.github.com/users/octocat/repos",
                                                                                                              "events_url": "https://api.github.com/users/octocat/events{/privacy}",
                                                                                                              "received_events_url": "https://api.github.com/users/octocat/received_events",
                                                                                                              "type": "User",
                                                                                                              "site_admin": false
                                                                                                            }
                                                                                                          ]
                                                                                                          
                                                                                                          tmp/developer.github.com/v3/repos/collaborators/index.html Collaborators | GitHub Developer Guide

                                                                                                          Collaborators

                                                                                                          List collaborators

                                                                                                          Note: The Nested Teams API is currently available for developers to preview. See the blog post for full details. To access the API, you must provide a custom media type in the Accept header:

                                                                                                          application/vnd.github.hellcat-preview+json
                                                                                                          

                                                                                                          Warning: The API may change without advance notice during the preview period. Preview features are not supported for production use. If you experience any issues, contact GitHub support.

                                                                                                          GET /repos/:owner/:repo/collaborators
                                                                                                          

                                                                                                          For organization-owned repositories, the list of collaborators includes outside collaborators, organization members with access through team memberships, organization members with access through default organization permissions, and organization owners.

                                                                                                          If you pass the hellcat-preview media type, team members will include the members of child teams.

                                                                                                          Parameters

                                                                                                          Name Type Description
                                                                                                          affiliation string Filter collaborators returned by their affiliation. Can be one of:
                                                                                                          * outside: All outside collaborators of an organization-owned repository.
                                                                                                          * direct: All collaborators with permissions to an organization-owned repository, regardless of organization membership status.
                                                                                                          * all: All collaborators the authenticated user can see.
                                                                                                          Default: all

                                                                                                          Response

                                                                                                          Status: 200 OK
                                                                                                          Link: <https://api.github.com/resource?page=2>; rel="next",
                                                                                                                <https://api.github.com/resource?page=5>; rel="last"
                                                                                                          
                                                                                                          [
                                                                                                            {
                                                                                                              "login": "octocat",
                                                                                                              "id": 1,
                                                                                                              "avatar_url": "https://github.com/images/error/octocat_happy.gif",
                                                                                                              "gravatar_id": "",
                                                                                                              "url": "https://api.github.com/users/octocat",
                                                                                                              "html_url": "https://github.com/octocat",
                                                                                                              "followers_url": "https://api.github.com/users/octocat/followers",
                                                                                                              "following_url": "https://api.github.com/users/octocat/following{/other_user}",
                                                                                                              "gists_url": "https://api.github.com/users/octocat/gists{/gist_id}",
                                                                                                              "starred_url": "https://api.github.com/users/octocat/starred{/owner}{/repo}",
                                                                                                              "subscriptions_url": "https://api.github.com/users/octocat/subscriptions",
                                                                                                              "organizations_url": "https://api.github.com/users/octocat/orgs",
                                                                                                              "repos_url": "https://api.github.com/users/octocat/repos",
                                                                                                              "events_url": "https://api.github.com/users/octocat/events{/privacy}",
                                                                                                              "received_events_url": "https://api.github.com/users/octocat/received_events",
                                                                                                              "type": "User",
                                                                                                              "site_admin": false,
                                                                                                              "permissions": {
                                                                                                                "pull": true,
                                                                                                                "push": true,
                                                                                                                "admin": false
                                                                                                              }
                                                                                                            }
                                                                                                          ]
                                                                                                          

                                                                                                          Check if a user is a collaborator

                                                                                                          Note: The Nested Teams API is currently available for developers to preview. See the blog post for full details. To access the API, you must provide a custom media type in the Accept header:

                                                                                                          application/vnd.github.hellcat-preview+json
                                                                                                          

                                                                                                          Warning: The API may change without advance notice during the preview period. Preview features are not supported for production use. If you experience any issues, contact GitHub support.

                                                                                                          GET /repos/:owner/:repo/collaborators/:username
                                                                                                          

                                                                                                          For organization-owned repositories, the list of collaborators includes outside collaborators, organization members with access through team memberships, organization members with access through default organization permissions, and organization owners.

                                                                                                          If you pass the hellcat-preview media type, team members will include the members of child teams.

                                                                                                          Response if user is a collaborator

                                                                                                          Status: 204 No Content
                                                                                                          

                                                                                                          Response if user is not a collaborator

                                                                                                          Status: 404 Not Found
                                                                                                          

                                                                                                          Review a user's permission level

                                                                                                          GET /repos/:owner/:repo/collaborators/:username/permission
                                                                                                          

                                                                                                          Possible values for the permission key: admin, write, read, none.

                                                                                                          Response if user has admin permissions

                                                                                                          Status: 200 OK
                                                                                                          
                                                                                                          {
                                                                                                            "permission": "admin",
                                                                                                            "user": {
                                                                                                              "login": "octocat",
                                                                                                              "id": 1,
                                                                                                              "avatar_url": "https://github.com/images/error/octocat_happy.gif",
                                                                                                              "gravatar_id": "",
                                                                                                              "url": "https://api.github.com/users/octocat",
                                                                                                              "html_url": "https://github.com/octocat",
                                                                                                              "followers_url": "https://api.github.com/users/octocat/followers",
                                                                                                              "following_url": "https://api.github.com/users/octocat/following{/other_user}",
                                                                                                              "gists_url": "https://api.github.com/users/octocat/gists{/gist_id}",
                                                                                                              "starred_url": "https://api.github.com/users/octocat/starred{/owner}{/repo}",
                                                                                                              "subscriptions_url": "https://api.github.com/users/octocat/subscriptions",
                                                                                                              "organizations_url": "https://api.github.com/users/octocat/orgs",
                                                                                                              "repos_url": "https://api.github.com/users/octocat/repos",
                                                                                                              "events_url": "https://api.github.com/users/octocat/events{/privacy}",
                                                                                                              "received_events_url": "https://api.github.com/users/octocat/received_events",
                                                                                                              "type": "User",
                                                                                                              "site_admin": false
                                                                                                            }
                                                                                                          }
                                                                                                          

                                                                                                          Add user as a collaborator

                                                                                                          PUT /repos/:owner/:repo/collaborators/:username
                                                                                                          

                                                                                                          Parameters

                                                                                                          Name Type Description
                                                                                                          permission string The permission to grant the collaborator. Only valid on organization-owned repositories. Can be one of:
                                                                                                          * pull - can pull, but not push to or administer this repository.
                                                                                                          * push - can pull and push, but not administer this repository.
                                                                                                          * admin - can pull, push and administer this repository.
                                                                                                          Default: push

                                                                                                          Note that, if you choose not to pass any parameters, you'll need to set Content-Length to zero when calling out to this endpoint. For more information, see "HTTP verbs."

                                                                                                          The invitee will receive a notification that they have been invited to the repository, which they must accept or decline. They may do this via the notifications page, the email they receive, or by using the repository invitations API endpoints.

                                                                                                          Rate limits

                                                                                                          To prevent abuse, you are limited to sending 50 invitations to a repository per 24 hour period. Note there is no limit if you are inviting organization members to an organization repository.

                                                                                                          Response

                                                                                                          Status: 204 No Content
                                                                                                          

                                                                                                          Response with preview media type

                                                                                                          Status: 201 Created
                                                                                                          
                                                                                                          {
                                                                                                            "id": 1,
                                                                                                            "repository": {
                                                                                                              "id": 1296269,
                                                                                                              "owner": {
                                                                                                                "login": "octocat",
                                                                                                                "id": 1,
                                                                                                                "avatar_url": "https://github.com/images/error/octocat_happy.gif",
                                                                                                                "gravatar_id": "",
                                                                                                                "url": "https://api.github.com/users/octocat",
                                                                                                                "html_url": "https://github.com/octocat",
                                                                                                                "followers_url": "https://api.github.com/users/octocat/followers",
                                                                                                                "following_url": "https://api.github.com/users/octocat/following{/other_user}",
                                                                                                                "gists_url": "https://api.github.com/users/octocat/gists{/gist_id}",
                                                                                                                "starred_url": "https://api.github.com/users/octocat/starred{/owner}{/repo}",
                                                                                                                "subscriptions_url": "https://api.github.com/users/octocat/subscriptions",
                                                                                                                "organizations_url": "https://api.github.com/users/octocat/orgs",
                                                                                                                "repos_url": "https://api.github.com/users/octocat/repos",
                                                                                                                "events_url": "https://api.github.com/users/octocat/events{/privacy}",
                                                                                                                "received_events_url": "https://api.github.com/users/octocat/received_events",
                                                                                                                "type": "User",
                                                                                                                "site_admin": false
                                                                                                              },
                                                                                                              "name": "Hello-World",
                                                                                                              "full_name": "octocat/Hello-World",
                                                                                                              "description": "This your first repo!",
                                                                                                              "private": false,
                                                                                                              "fork": true,
                                                                                                              "url": "https://api.github.com/repos/octocat/Hello-World",
                                                                                                              "html_url": "https://github.com/octocat/Hello-World",
                                                                                                              "archive_url": "http://api.github.com/repos/octocat/Hello-World/{archive_format}{/ref}",
                                                                                                              "assignees_url": "http://api.github.com/repos/octocat/Hello-World/assignees{/user}",
                                                                                                              "blobs_url": "http://api.github.com/repos/octocat/Hello-World/git/blobs{/sha}",
                                                                                                              "branches_url": "http://api.github.com/repos/octocat/Hello-World/branches{/branch}",
                                                                                                              "clone_url": "https://github.com/octocat/Hello-World.git",
                                                                                                              "collaborators_url": "http://api.github.com/repos/octocat/Hello-World/collaborators{/collaborator}",
                                                                                                              "comments_url": "http://api.github.com/repos/octocat/Hello-World/comments{/number}",
                                                                                                              "commits_url": "http://api.github.com/repos/octocat/Hello-World/commits{/sha}",
                                                                                                              "compare_url": "http://api.github.com/repos/octocat/Hello-World/compare/{base}...{head}",
                                                                                                              "contents_url": "http://api.github.com/repos/octocat/Hello-World/contents/{+path}",
                                                                                                              "contributors_url": "http://api.github.com/repos/octocat/Hello-World/contributors",
                                                                                                              "deployments_url": "http://api.github.com/repos/octocat/Hello-World/deployments",
                                                                                                              "downloads_url": "http://api.github.com/repos/octocat/Hello-World/downloads",
                                                                                                              "events_url": "http://api.github.com/repos/octocat/Hello-World/events",
                                                                                                              "forks_url": "http://api.github.com/repos/octocat/Hello-World/forks",
                                                                                                              "git_commits_url": "http://api.github.com/repos/octocat/Hello-World/git/commits{/sha}",
                                                                                                              "git_refs_url": "http://api.github.com/repos/octocat/Hello-World/git/refs{/sha}",
                                                                                                              "git_tags_url": "http://api.github.com/repos/octocat/Hello-World/git/tags{/sha}",
                                                                                                              "git_url": "git:github.com/octocat/Hello-World.git",
                                                                                                              "hooks_url": "http://api.github.com/repos/octocat/Hello-World/hooks",
                                                                                                              "issue_comment_url": "http://api.github.com/repos/octocat/Hello-World/issues/comments{/number}",
                                                                                                              "issue_events_url": "http://api.github.com/repos/octocat/Hello-World/issues/events{/number}",
                                                                                                              "issues_url": "http://api.github.com/repos/octocat/Hello-World/issues{/number}",
                                                                                                              "keys_url": "http://api.github.com/repos/octocat/Hello-World/keys{/key_id}",
                                                                                                              "labels_url": "http://api.github.com/repos/octocat/Hello-World/labels{/name}",
                                                                                                              "languages_url": "http://api.github.com/repos/octocat/Hello-World/languages",
                                                                                                              "merges_url": "http://api.github.com/repos/octocat/Hello-World/merges",
                                                                                                              "milestones_url": "http://api.github.com/repos/octocat/Hello-World/milestones{/number}",
                                                                                                              "mirror_url": "git:git.example.com/octocat/Hello-World",
                                                                                                              "notifications_url": "http://api.github.com/repos/octocat/Hello-World/notifications{?since,all,participating}",
                                                                                                              "pulls_url": "http://api.github.com/repos/octocat/Hello-World/pulls{/number}",
                                                                                                              "releases_url": "http://api.github.com/repos/octocat/Hello-World/releases{/id}",
                                                                                                              "ssh_url": "git@github.com:octocat/Hello-World.git",
                                                                                                              "stargazers_url": "http://api.github.com/repos/octocat/Hello-World/stargazers",
                                                                                                              "statuses_url": "http://api.github.com/repos/octocat/Hello-World/statuses/{sha}",
                                                                                                              "subscribers_url": "http://api.github.com/repos/octocat/Hello-World/subscribers",
                                                                                                              "subscription_url": "http://api.github.com/repos/octocat/Hello-World/subscription",
                                                                                                              "svn_url": "https://svn.github.com/octocat/Hello-World",
                                                                                                              "tags_url": "http://api.github.com/repos/octocat/Hello-World/tags",
                                                                                                              "teams_url": "http://api.github.com/repos/octocat/Hello-World/teams",
                                                                                                              "trees_url": "http://api.github.com/repos/octocat/Hello-World/git/trees{/sha}",
                                                                                                              "homepage": "https://github.com",
                                                                                                              "language": null,
                                                                                                              "forks_count": 9,
                                                                                                              "stargazers_count": 80,
                                                                                                              "watchers_count": 80,
                                                                                                              "size": 108,
                                                                                                              "default_branch": "master",
                                                                                                              "open_issues_count": 0,
                                                                                                              "topics": [
                                                                                                                "octocat",
                                                                                                                "atom",
                                                                                                                "electron",
                                                                                                                "API"
                                                                                                              ],
                                                                                                              "has_issues": true,
                                                                                                              "has_wiki": true,
                                                                                                              "has_pages": false,
                                                                                                              "has_downloads": true,
                                                                                                              "archived": false,
                                                                                                              "pushed_at": "2011-01-26T19:06:43Z",
                                                                                                              "created_at": "2011-01-26T19:01:12Z",
                                                                                                              "updated_at": "2011-01-26T19:14:43Z",
                                                                                                              "permissions": {
                                                                                                                "admin": false,
                                                                                                                "push": false,
                                                                                                                "pull": true
                                                                                                              },
                                                                                                              "allow_rebase_merge": true,
                                                                                                              "allow_squash_merge": true,
                                                                                                              "allow_merge_commit": true,
                                                                                                              "subscribers_count": 42,
                                                                                                              "network_count": 0
                                                                                                            },
                                                                                                            "invitee": {
                                                                                                              "login": "octocat",
                                                                                                              "id": 1,
                                                                                                              "avatar_url": "https://github.com/images/error/octocat_happy.gif",
                                                                                                              "gravatar_id": "",
                                                                                                              "url": "https://api.github.com/users/octocat",
                                                                                                              "html_url": "https://github.com/octocat",
                                                                                                              "followers_url": "https://api.github.com/users/octocat/followers",
                                                                                                              "following_url": "https://api.github.com/users/octocat/following{/other_user}",
                                                                                                              "gists_url": "https://api.github.com/users/octocat/gists{/gist_id}",
                                                                                                              "starred_url": "https://api.github.com/users/octocat/starred{/owner}{/repo}",
                                                                                                              "subscriptions_url": "https://api.github.com/users/octocat/subscriptions",
                                                                                                              "organizations_url": "https://api.github.com/users/octocat/orgs",
                                                                                                              "repos_url": "https://api.github.com/users/octocat/repos",
                                                                                                              "events_url": "https://api.github.com/users/octocat/events{/privacy}",
                                                                                                              "received_events_url": "https://api.github.com/users/octocat/received_events",
                                                                                                              "type": "User",
                                                                                                              "site_admin": false
                                                                                                            },
                                                                                                            "inviter": {
                                                                                                              "login": "octocat",
                                                                                                              "id": 1,
                                                                                                              "avatar_url": "https://github.com/images/error/octocat_happy.gif",
                                                                                                              "gravatar_id": "",
                                                                                                              "url": "https://api.github.com/users/octocat",
                                                                                                              "html_url": "https://github.com/octocat",
                                                                                                              "followers_url": "https://api.github.com/users/octocat/followers",
                                                                                                              "following_url": "https://api.github.com/users/octocat/following{/other_user}",
                                                                                                              "gists_url": "https://api.github.com/users/octocat/gists{/gist_id}",
                                                                                                              "starred_url": "https://api.github.com/users/octocat/starred{/owner}{/repo}",
                                                                                                              "subscriptions_url": "https://api.github.com/users/octocat/subscriptions",
                                                                                                              "organizations_url": "https://api.github.com/users/octocat/orgs",
                                                                                                              "repos_url": "https://api.github.com/users/octocat/repos",
                                                                                                              "events_url": "https://api.github.com/users/octocat/events{/privacy}",
                                                                                                              "received_events_url": "https://api.github.com/users/octocat/received_events",
                                                                                                              "type": "User",
                                                                                                              "site_admin": false
                                                                                                            },
                                                                                                            "permissions": "write",
                                                                                                            "created_at": "2016-06-13T14:52:50-05:00",
                                                                                                            "url": "https://api.github.com/user/repository_invitations/1296269",
                                                                                                            "html_url": "https://github.com/octocat/Hello-World/invitations"
                                                                                                          }
                                                                                                          

                                                                                                          Remove user as a collaborator

                                                                                                          DELETE /repos/:owner/:repo/collaborators/:username
                                                                                                          

                                                                                                          Response

                                                                                                          Status: 204 No Content
                                                                                                          
                                                                                                          tmp/developer.github.com/v3/repos/comments/index.html Comments | GitHub Developer Guide

                                                                                                          Comments

                                                                                                          List commit comments for a repository

                                                                                                          Commit Comments use these custom media types. You can read more about the use of media types in the API here.

                                                                                                          Comments are ordered by ascending ID.

                                                                                                          GET /repos/:owner/:repo/comments
                                                                                                          

                                                                                                          Response

                                                                                                          Status: 200 OK
                                                                                                          Link: <https://api.github.com/resource?page=2>; rel="next",
                                                                                                                <https://api.github.com/resource?page=5>; rel="last"
                                                                                                          
                                                                                                          [
                                                                                                            {
                                                                                                              "html_url": "https://github.com/octocat/Hello-World/commit/6dcb09b5b57875f334f61aebed695e2e4193db5e#commitcomment-1",
                                                                                                              "url": "https://api.github.com/repos/octocat/Hello-World/comments/1",
                                                                                                              "id": 1,
                                                                                                              "body": "Great stuff",
                                                                                                              "path": "file1.txt",
                                                                                                              "position": 4,
                                                                                                              "line": 14,
                                                                                                              "commit_id": "6dcb09b5b57875f334f61aebed695e2e4193db5e",
                                                                                                              "user": {
                                                                                                                "login": "octocat",
                                                                                                                "id": 1,
                                                                                                                "avatar_url": "https://github.com/images/error/octocat_happy.gif",
                                                                                                                "gravatar_id": "",
                                                                                                                "url": "https://api.github.com/users/octocat",
                                                                                                                "html_url": "https://github.com/octocat",
                                                                                                                "followers_url": "https://api.github.com/users/octocat/followers",
                                                                                                                "following_url": "https://api.github.com/users/octocat/following{/other_user}",
                                                                                                                "gists_url": "https://api.github.com/users/octocat/gists{/gist_id}",
                                                                                                                "starred_url": "https://api.github.com/users/octocat/starred{/owner}{/repo}",
                                                                                                                "subscriptions_url": "https://api.github.com/users/octocat/subscriptions",
                                                                                                                "organizations_url": "https://api.github.com/users/octocat/orgs",
                                                                                                                "repos_url": "https://api.github.com/users/octocat/repos",
                                                                                                                "events_url": "https://api.github.com/users/octocat/events{/privacy}",
                                                                                                                "received_events_url": "https://api.github.com/users/octocat/received_events",
                                                                                                                "type": "User",
                                                                                                                "site_admin": false
                                                                                                              },
                                                                                                              "created_at": "2011-04-14T16:00:49Z",
                                                                                                              "updated_at": "2011-04-14T16:00:49Z"
                                                                                                            }
                                                                                                          ]
                                                                                                          

                                                                                                          Reactions summary

                                                                                                          An additional reactions object in the commit comment payload is currently available for developers to preview. During the preview period, the APIs may change without advance notice. Please see the blog post for full details.

                                                                                                          To access the API you must provide a custom media type in the Accept header:

                                                                                                            application/vnd.github.squirrel-girl-preview
                                                                                                          

                                                                                                          The reactions key will have the following payload where url can be used to construct the API location for listing and creating reactions.

                                                                                                          {
                                                                                                            "total_count": 5,
                                                                                                            "+1": 3,
                                                                                                            "-1": 1,
                                                                                                            "laugh": 0,
                                                                                                            "confused": 0,
                                                                                                            "heart": 1,
                                                                                                            "hooray": 0,
                                                                                                            "url": "https://api.github.com/repos/octocat/Hello-World/comments/1/reactions"
                                                                                                          }
                                                                                                          

                                                                                                          List comments for a single commit

                                                                                                          GET /repos/:owner/:repo/commits/:ref/comments
                                                                                                          

                                                                                                          Response

                                                                                                          Status: 200 OK
                                                                                                          Link: <https://api.github.com/resource?page=2>; rel="next",
                                                                                                                <https://api.github.com/resource?page=5>; rel="last"
                                                                                                          
                                                                                                          [
                                                                                                            {
                                                                                                              "html_url": "https://github.com/octocat/Hello-World/commit/6dcb09b5b57875f334f61aebed695e2e4193db5e#commitcomment-1",
                                                                                                              "url": "https://api.github.com/repos/octocat/Hello-World/comments/1",
                                                                                                              "id": 1,
                                                                                                              "body": "Great stuff",
                                                                                                              "path": "file1.txt",
                                                                                                              "position": 4,
                                                                                                              "line": 14,
                                                                                                              "commit_id": "6dcb09b5b57875f334f61aebed695e2e4193db5e",
                                                                                                              "user": {
                                                                                                                "login": "octocat",
                                                                                                                "id": 1,
                                                                                                                "avatar_url": "https://github.com/images/error/octocat_happy.gif",
                                                                                                                "gravatar_id": "",
                                                                                                                "url": "https://api.github.com/users/octocat",
                                                                                                                "html_url": "https://github.com/octocat",
                                                                                                                "followers_url": "https://api.github.com/users/octocat/followers",
                                                                                                                "following_url": "https://api.github.com/users/octocat/following{/other_user}",
                                                                                                                "gists_url": "https://api.github.com/users/octocat/gists{/gist_id}",
                                                                                                                "starred_url": "https://api.github.com/users/octocat/starred{/owner}{/repo}",
                                                                                                                "subscriptions_url": "https://api.github.com/users/octocat/subscriptions",
                                                                                                                "organizations_url": "https://api.github.com/users/octocat/orgs",
                                                                                                                "repos_url": "https://api.github.com/users/octocat/repos",
                                                                                                                "events_url": "https://api.github.com/users/octocat/events{/privacy}",
                                                                                                                "received_events_url": "https://api.github.com/users/octocat/received_events",
                                                                                                                "type": "User",
                                                                                                                "site_admin": false
                                                                                                              },
                                                                                                              "created_at": "2011-04-14T16:00:49Z",
                                                                                                              "updated_at": "2011-04-14T16:00:49Z"
                                                                                                            }
                                                                                                          ]
                                                                                                          

                                                                                                          Reactions summary

                                                                                                          An additional reactions object in the commit comment payload is currently available for developers to preview. During the preview period, the APIs may change without advance notice. Please see the blog post for full details.

                                                                                                          To access the API you must provide a custom media type in the Accept header:

                                                                                                            application/vnd.github.squirrel-girl-preview
                                                                                                          

                                                                                                          The reactions key will have the following payload where url can be used to construct the API location for listing and creating reactions.

                                                                                                          {
                                                                                                            "total_count": 5,
                                                                                                            "+1": 3,
                                                                                                            "-1": 1,
                                                                                                            "laugh": 0,
                                                                                                            "confused": 0,
                                                                                                            "heart": 1,
                                                                                                            "hooray": 0,
                                                                                                            "url": "https://api.github.com/repos/octocat/Hello-World/comments/1/reactions"
                                                                                                          }
                                                                                                          

                                                                                                          Create a commit comment

                                                                                                          POST /repos/:owner/:repo/commits/:sha/comments
                                                                                                          

                                                                                                          Input

                                                                                                          Name Type Description
                                                                                                          body string Required. The contents of the comment.
                                                                                                          path string Relative path of the file to comment on.
                                                                                                          position integer Line index in the diff to comment on.
                                                                                                          line integer Deprecated. Use position parameter instead. Line number in the file to comment on.

                                                                                                          Example

                                                                                                          {
                                                                                                            "body": "Great stuff",
                                                                                                            "path": "file1.txt",
                                                                                                            "position": 4,
                                                                                                            "line": null
                                                                                                          }
                                                                                                          

                                                                                                          Response

                                                                                                          Status: 201 Created
                                                                                                          Location: https://api.github.com/repos/octocat/Hello-World/comments/1
                                                                                                          
                                                                                                          {
                                                                                                            "html_url": "https://github.com/octocat/Hello-World/commit/6dcb09b5b57875f334f61aebed695e2e4193db5e#commitcomment-1",
                                                                                                            "url": "https://api.github.com/repos/octocat/Hello-World/comments/1",
                                                                                                            "id": 1,
                                                                                                            "body": "Great stuff",
                                                                                                            "path": "file1.txt",
                                                                                                            "position": 4,
                                                                                                            "line": 14,
                                                                                                            "commit_id": "6dcb09b5b57875f334f61aebed695e2e4193db5e",
                                                                                                            "user": {
                                                                                                              "login": "octocat",
                                                                                                              "id": 1,
                                                                                                              "avatar_url": "https://github.com/images/error/octocat_happy.gif",
                                                                                                              "gravatar_id": "",
                                                                                                              "url": "https://api.github.com/users/octocat",
                                                                                                              "html_url": "https://github.com/octocat",
                                                                                                              "followers_url": "https://api.github.com/users/octocat/followers",
                                                                                                              "following_url": "https://api.github.com/users/octocat/following{/other_user}",
                                                                                                              "gists_url": "https://api.github.com/users/octocat/gists{/gist_id}",
                                                                                                              "starred_url": "https://api.github.com/users/octocat/starred{/owner}{/repo}",
                                                                                                              "subscriptions_url": "https://api.github.com/users/octocat/subscriptions",
                                                                                                              "organizations_url": "https://api.github.com/users/octocat/orgs",
                                                                                                              "repos_url": "https://api.github.com/users/octocat/repos",
                                                                                                              "events_url": "https://api.github.com/users/octocat/events{/privacy}",
                                                                                                              "received_events_url": "https://api.github.com/users/octocat/received_events",
                                                                                                              "type": "User",
                                                                                                              "site_admin": false
                                                                                                            },
                                                                                                            "created_at": "2011-04-14T16:00:49Z",
                                                                                                            "updated_at": "2011-04-14T16:00:49Z"
                                                                                                          }
                                                                                                          

                                                                                                          Get a single commit comment

                                                                                                          GET /repos/:owner/:repo/comments/:id
                                                                                                          

                                                                                                          Response

                                                                                                          Status: 200 OK
                                                                                                          
                                                                                                          {
                                                                                                            "html_url": "https://github.com/octocat/Hello-World/commit/6dcb09b5b57875f334f61aebed695e2e4193db5e#commitcomment-1",
                                                                                                            "url": "https://api.github.com/repos/octocat/Hello-World/comments/1",
                                                                                                            "id": 1,
                                                                                                            "body": "Great stuff",
                                                                                                            "path": "file1.txt",
                                                                                                            "position": 4,
                                                                                                            "line": 14,
                                                                                                            "commit_id": "6dcb09b5b57875f334f61aebed695e2e4193db5e",
                                                                                                            "user": {
                                                                                                              "login": "octocat",
                                                                                                              "id": 1,
                                                                                                              "avatar_url": "https://github.com/images/error/octocat_happy.gif",
                                                                                                              "gravatar_id": "",
                                                                                                              "url": "https://api.github.com/users/octocat",
                                                                                                              "html_url": "https://github.com/octocat",
                                                                                                              "followers_url": "https://api.github.com/users/octocat/followers",
                                                                                                              "following_url": "https://api.github.com/users/octocat/following{/other_user}",
                                                                                                              "gists_url": "https://api.github.com/users/octocat/gists{/gist_id}",
                                                                                                              "starred_url": "https://api.github.com/users/octocat/starred{/owner}{/repo}",
                                                                                                              "subscriptions_url": "https://api.github.com/users/octocat/subscriptions",
                                                                                                              "organizations_url": "https://api.github.com/users/octocat/orgs",
                                                                                                              "repos_url": "https://api.github.com/users/octocat/repos",
                                                                                                              "events_url": "https://api.github.com/users/octocat/events{/privacy}",
                                                                                                              "received_events_url": "https://api.github.com/users/octocat/received_events",
                                                                                                              "type": "User",
                                                                                                              "site_admin": false
                                                                                                            },
                                                                                                            "created_at": "2011-04-14T16:00:49Z",
                                                                                                            "updated_at": "2011-04-14T16:00:49Z"
                                                                                                          }
                                                                                                          

                                                                                                          Reactions summary

                                                                                                          An additional reactions object in the commit comment payload is currently available for developers to preview. During the preview period, the APIs may change without advance notice. Please see the blog post for full details.

                                                                                                          To access the API you must provide a custom media type in the Accept header:

                                                                                                            application/vnd.github.squirrel-girl-preview
                                                                                                          

                                                                                                          The reactions key will have the following payload where url can be used to construct the API location for listing and creating reactions.

                                                                                                          {
                                                                                                            "total_count": 5,
                                                                                                            "+1": 3,
                                                                                                            "-1": 1,
                                                                                                            "laugh": 0,
                                                                                                            "confused": 0,
                                                                                                            "heart": 1,
                                                                                                            "hooray": 0,
                                                                                                            "url": "https://api.github.com/repos/octocat/Hello-World/comments/1/reactions"
                                                                                                          }
                                                                                                          

                                                                                                          Update a commit comment

                                                                                                          PATCH /repos/:owner/:repo/comments/:id
                                                                                                          

                                                                                                          Input

                                                                                                          Name Type Description
                                                                                                          body string Required. The contents of the comment

                                                                                                          Example

                                                                                                          {
                                                                                                            "body": "Nice change"
                                                                                                          }
                                                                                                          

                                                                                                          Response

                                                                                                          Status: 200 OK
                                                                                                          
                                                                                                          {
                                                                                                            "html_url": "https://github.com/octocat/Hello-World/commit/6dcb09b5b57875f334f61aebed695e2e4193db5e#commitcomment-1",
                                                                                                            "url": "https://api.github.com/repos/octocat/Hello-World/comments/1",
                                                                                                            "id": 1,
                                                                                                            "body": "Nice change",
                                                                                                            "path": "file1.txt",
                                                                                                            "position": 4,
                                                                                                            "line": 14,
                                                                                                            "commit_id": "6dcb09b5b57875f334f61aebed695e2e4193db5e",
                                                                                                            "user": {
                                                                                                              "login": "octocat",
                                                                                                              "id": 1,
                                                                                                              "avatar_url": "https://github.com/images/error/octocat_happy.gif",
                                                                                                              "gravatar_id": "",
                                                                                                              "url": "https://api.github.com/users/octocat",
                                                                                                              "html_url": "https://github.com/octocat",
                                                                                                              "followers_url": "https://api.github.com/users/octocat/followers",
                                                                                                              "following_url": "https://api.github.com/users/octocat/following{/other_user}",
                                                                                                              "gists_url": "https://api.github.com/users/octocat/gists{/gist_id}",
                                                                                                              "starred_url": "https://api.github.com/users/octocat/starred{/owner}{/repo}",
                                                                                                              "subscriptions_url": "https://api.github.com/users/octocat/subscriptions",
                                                                                                              "organizations_url": "https://api.github.com/users/octocat/orgs",
                                                                                                              "repos_url": "https://api.github.com/users/octocat/repos",
                                                                                                              "events_url": "https://api.github.com/users/octocat/events{/privacy}",
                                                                                                              "received_events_url": "https://api.github.com/users/octocat/received_events",
                                                                                                              "type": "User",
                                                                                                              "site_admin": false
                                                                                                            },
                                                                                                            "created_at": "2011-04-14T16:00:49Z",
                                                                                                            "updated_at": "2011-04-14T16:00:49Z"
                                                                                                          }
                                                                                                          

                                                                                                          Delete a commit comment

                                                                                                          DELETE /repos/:owner/:repo/comments/:id
                                                                                                          

                                                                                                          Response

                                                                                                          Status: 204 No Content
                                                                                                          

                                                                                                          Custom media types

                                                                                                          These are the supported media types for commit comments. You can read more about the use of media types in the API here.

                                                                                                          application/vnd.github-commitcomment.raw+json
                                                                                                          application/vnd.github-commitcomment.text+json
                                                                                                          application/vnd.github-commitcomment.html+json
                                                                                                          application/vnd.github-commitcomment.full+json
                                                                                                          
                                                                                                          tmp/developer.github.com/v3/repos/commits/index.html Commits | GitHub Developer Guide

                                                                                                          Commits

                                                                                                          The Repo Commits API supports listing, viewing, and comparing commits in a repository.

                                                                                                          List commits on a repository

                                                                                                          GET /repos/:owner/:repo/commits
                                                                                                          

                                                                                                          Parameters

                                                                                                          Name Type Description
                                                                                                          sha string SHA or branch to start listing commits from. Default: the repository’s default branch (usually master).
                                                                                                          path string Only commits containing this file path will be returned.
                                                                                                          author string GitHub login or email address by which to filter by commit author.
                                                                                                          since string Only commits after this date will be returned. This is a timestamp in ISO 8601 format: YYYY-MM-DDTHH:MM:SSZ.
                                                                                                          until string Only commits before this date will be returned. This is a timestamp in ISO 8601 format: YYYY-MM-DDTHH:MM:SSZ.

                                                                                                          Response

                                                                                                          Status: 200 OK
                                                                                                          Link: <https://api.github.com/resource?page=2>; rel="next",
                                                                                                                <https://api.github.com/resource?page=5>; rel="last"
                                                                                                          
                                                                                                          [
                                                                                                            {
                                                                                                              "url": "https://api.github.com/repos/octocat/Hello-World/commits/6dcb09b5b57875f334f61aebed695e2e4193db5e",
                                                                                                              "sha": "6dcb09b5b57875f334f61aebed695e2e4193db5e",
                                                                                                              "html_url": "https://github.com/octocat/Hello-World/commit/6dcb09b5b57875f334f61aebed695e2e4193db5e",
                                                                                                              "comments_url": "https://api.github.com/repos/octocat/Hello-World/commits/6dcb09b5b57875f334f61aebed695e2e4193db5e/comments",
                                                                                                              "commit": {
                                                                                                                "url": "https://api.github.com/repos/octocat/Hello-World/git/commits/6dcb09b5b57875f334f61aebed695e2e4193db5e",
                                                                                                                "author": {
                                                                                                                  "name": "Monalisa Octocat",
                                                                                                                  "email": "support@github.com",
                                                                                                                  "date": "2011-04-14T16:00:49Z"
                                                                                                                },
                                                                                                                "committer": {
                                                                                                                  "name": "Monalisa Octocat",
                                                                                                                  "email": "support@github.com",
                                                                                                                  "date": "2011-04-14T16:00:49Z"
                                                                                                                },
                                                                                                                "message": "Fix all the bugs",
                                                                                                                "tree": {
                                                                                                                  "url": "https://api.github.com/repos/octocat/Hello-World/tree/6dcb09b5b57875f334f61aebed695e2e4193db5e",
                                                                                                                  "sha": "6dcb09b5b57875f334f61aebed695e2e4193db5e"
                                                                                                                },
                                                                                                                "comment_count": 0,
                                                                                                                "verification": {
                                                                                                                  "verified": false,
                                                                                                                  "reason": "unsigned",
                                                                                                                  "signature": null,
                                                                                                                  "payload": null
                                                                                                                }
                                                                                                              },
                                                                                                              "author": {
                                                                                                                "login": "octocat",
                                                                                                                "id": 1,
                                                                                                                "avatar_url": "https://github.com/images/error/octocat_happy.gif",
                                                                                                                "gravatar_id": "",
                                                                                                                "url": "https://api.github.com/users/octocat",
                                                                                                                "html_url": "https://github.com/octocat",
                                                                                                                "followers_url": "https://api.github.com/users/octocat/followers",
                                                                                                                "following_url": "https://api.github.com/users/octocat/following{/other_user}",
                                                                                                                "gists_url": "https://api.github.com/users/octocat/gists{/gist_id}",
                                                                                                                "starred_url": "https://api.github.com/users/octocat/starred{/owner}{/repo}",
                                                                                                                "subscriptions_url": "https://api.github.com/users/octocat/subscriptions",
                                                                                                                "organizations_url": "https://api.github.com/users/octocat/orgs",
                                                                                                                "repos_url": "https://api.github.com/users/octocat/repos",
                                                                                                                "events_url": "https://api.github.com/users/octocat/events{/privacy}",
                                                                                                                "received_events_url": "https://api.github.com/users/octocat/received_events",
                                                                                                                "type": "User",
                                                                                                                "site_admin": false
                                                                                                              },
                                                                                                              "committer": {
                                                                                                                "login": "octocat",
                                                                                                                "id": 1,
                                                                                                                "avatar_url": "https://github.com/images/error/octocat_happy.gif",
                                                                                                                "gravatar_id": "",
                                                                                                                "url": "https://api.github.com/users/octocat",
                                                                                                                "html_url": "https://github.com/octocat",
                                                                                                                "followers_url": "https://api.github.com/users/octocat/followers",
                                                                                                                "following_url": "https://api.github.com/users/octocat/following{/other_user}",
                                                                                                                "gists_url": "https://api.github.com/users/octocat/gists{/gist_id}",
                                                                                                                "starred_url": "https://api.github.com/users/octocat/starred{/owner}{/repo}",
                                                                                                                "subscriptions_url": "https://api.github.com/users/octocat/subscriptions",
                                                                                                                "organizations_url": "https://api.github.com/users/octocat/orgs",
                                                                                                                "repos_url": "https://api.github.com/users/octocat/repos",
                                                                                                                "events_url": "https://api.github.com/users/octocat/events{/privacy}",
                                                                                                                "received_events_url": "https://api.github.com/users/octocat/received_events",
                                                                                                                "type": "User",
                                                                                                                "site_admin": false
                                                                                                              },
                                                                                                              "parents": [
                                                                                                                {
                                                                                                                  "url": "https://api.github.com/repos/octocat/Hello-World/commits/6dcb09b5b57875f334f61aebed695e2e4193db5e",
                                                                                                                  "sha": "6dcb09b5b57875f334f61aebed695e2e4193db5e"
                                                                                                                }
                                                                                                              ]
                                                                                                            }
                                                                                                          ]
                                                                                                          

                                                                                                          Get a single commit

                                                                                                          GET /repos/:owner/:repo/commits/:sha
                                                                                                          

                                                                                                          Response

                                                                                                          Diffs with binary data will have no 'patch' property. Pass the appropriate media type to fetch diff and patch formats.

                                                                                                          Status: 200 OK
                                                                                                          
                                                                                                          {
                                                                                                            "url": "https://api.github.com/repos/octocat/Hello-World/commits/6dcb09b5b57875f334f61aebed695e2e4193db5e",
                                                                                                            "sha": "6dcb09b5b57875f334f61aebed695e2e4193db5e",
                                                                                                            "html_url": "https://github.com/octocat/Hello-World/commit/6dcb09b5b57875f334f61aebed695e2e4193db5e",
                                                                                                            "comments_url": "https://api.github.com/repos/octocat/Hello-World/commits/6dcb09b5b57875f334f61aebed695e2e4193db5e/comments",
                                                                                                            "commit": {
                                                                                                              "url": "https://api.github.com/repos/octocat/Hello-World/git/commits/6dcb09b5b57875f334f61aebed695e2e4193db5e",
                                                                                                              "author": {
                                                                                                                "name": "Monalisa Octocat",
                                                                                                                "email": "support@github.com",
                                                                                                                "date": "2011-04-14T16:00:49Z"
                                                                                                              },
                                                                                                              "committer": {
                                                                                                                "name": "Monalisa Octocat",
                                                                                                                "email": "support@github.com",
                                                                                                                "date": "2011-04-14T16:00:49Z"
                                                                                                              },
                                                                                                              "message": "Fix all the bugs",
                                                                                                              "tree": {
                                                                                                                "url": "https://api.github.com/repos/octocat/Hello-World/tree/6dcb09b5b57875f334f61aebed695e2e4193db5e",
                                                                                                                "sha": "6dcb09b5b57875f334f61aebed695e2e4193db5e"
                                                                                                              },
                                                                                                              "comment_count": 0,
                                                                                                              "verification": {
                                                                                                                "verified": false,
                                                                                                                "reason": "unsigned",
                                                                                                                "signature": null,
                                                                                                                "payload": null
                                                                                                              }
                                                                                                            },
                                                                                                            "author": {
                                                                                                              "login": "octocat",
                                                                                                              "id": 1,
                                                                                                              "avatar_url": "https://github.com/images/error/octocat_happy.gif",
                                                                                                              "gravatar_id": "",
                                                                                                              "url": "https://api.github.com/users/octocat",
                                                                                                              "html_url": "https://github.com/octocat",
                                                                                                              "followers_url": "https://api.github.com/users/octocat/followers",
                                                                                                              "following_url": "https://api.github.com/users/octocat/following{/other_user}",
                                                                                                              "gists_url": "https://api.github.com/users/octocat/gists{/gist_id}",
                                                                                                              "starred_url": "https://api.github.com/users/octocat/starred{/owner}{/repo}",
                                                                                                              "subscriptions_url": "https://api.github.com/users/octocat/subscriptions",
                                                                                                              "organizations_url": "https://api.github.com/users/octocat/orgs",
                                                                                                              "repos_url": "https://api.github.com/users/octocat/repos",
                                                                                                              "events_url": "https://api.github.com/users/octocat/events{/privacy}",
                                                                                                              "received_events_url": "https://api.github.com/users/octocat/received_events",
                                                                                                              "type": "User",
                                                                                                              "site_admin": false
                                                                                                            },
                                                                                                            "committer": {
                                                                                                              "login": "octocat",
                                                                                                              "id": 1,
                                                                                                              "avatar_url": "https://github.com/images/error/octocat_happy.gif",
                                                                                                              "gravatar_id": "",
                                                                                                              "url": "https://api.github.com/users/octocat",
                                                                                                              "html_url": "https://github.com/octocat",
                                                                                                              "followers_url": "https://api.github.com/users/octocat/followers",
                                                                                                              "following_url": "https://api.github.com/users/octocat/following{/other_user}",
                                                                                                              "gists_url": "https://api.github.com/users/octocat/gists{/gist_id}",
                                                                                                              "starred_url": "https://api.github.com/users/octocat/starred{/owner}{/repo}",
                                                                                                              "subscriptions_url": "https://api.github.com/users/octocat/subscriptions",
                                                                                                              "organizations_url": "https://api.github.com/users/octocat/orgs",
                                                                                                              "repos_url": "https://api.github.com/users/octocat/repos",
                                                                                                              "events_url": "https://api.github.com/users/octocat/events{/privacy}",
                                                                                                              "received_events_url": "https://api.github.com/users/octocat/received_events",
                                                                                                              "type": "User",
                                                                                                              "site_admin": false
                                                                                                            },
                                                                                                            "parents": [
                                                                                                              {
                                                                                                                "url": "https://api.github.com/repos/octocat/Hello-World/commits/6dcb09b5b57875f334f61aebed695e2e4193db5e",
                                                                                                                "sha": "6dcb09b5b57875f334f61aebed695e2e4193db5e"
                                                                                                              }
                                                                                                            ],
                                                                                                            "stats": {
                                                                                                              "additions": 104,
                                                                                                              "deletions": 4,
                                                                                                              "total": 108
                                                                                                            },
                                                                                                            "files": [
                                                                                                              {
                                                                                                                "filename": "file1.txt",
                                                                                                                "additions": 10,
                                                                                                                "deletions": 2,
                                                                                                                "changes": 12,
                                                                                                                "status": "modified",
                                                                                                                "raw_url": "https://github.com/octocat/Hello-World/raw/7ca483543807a51b6079e54ac4cc392bc29ae284/file1.txt",
                                                                                                                "blob_url": "https://github.com/octocat/Hello-World/blob/7ca483543807a51b6079e54ac4cc392bc29ae284/file1.txt",
                                                                                                                "patch": "@@ -29,7 +29,7 @@\n....."
                                                                                                              }
                                                                                                            ]
                                                                                                          }
                                                                                                          

                                                                                                          Get the SHA-1 of a commit reference

                                                                                                          Users with read access can get the SHA-1 of a commit reference:

                                                                                                          GET /repos/:owner/:repo/commits/:ref
                                                                                                          

                                                                                                          To access the API you must provide a custom media type in the Accept header:

                                                                                                          application/vnd.github.VERSION.sha
                                                                                                          

                                                                                                          To check if a remote reference's SHA-1 is the same as your local reference's SHA-1, make a GET request and provide the current SHA-1 for the local reference as the ETag.

                                                                                                          Response

                                                                                                          The SHA-1 of the commit reference.

                                                                                                          Status: 200 OK
                                                                                                          
                                                                                                          814412cfbd631109df337e16c807207e78c0d24e
                                                                                                          

                                                                                                          Compare two commits

                                                                                                          GET /repos/:owner/:repo/compare/:base...:head
                                                                                                          

                                                                                                          Both :base and :head must be branch names in :repo. To compare branches across other repositories in the same network as :repo, use the format <USERNAME>:branch. For example:

                                                                                                          GET /repos/:owner/:repo/compare/hubot:branchname...octocat:branchname
                                                                                                          

                                                                                                          Response

                                                                                                          The response from the API is equivalent to running the git log base..head command; however, commits are returned in reverse chronological order.

                                                                                                          Pass the appropriate media type to fetch diff and patch formats.

                                                                                                          {
                                                                                                            "url": "https://api.github.com/repos/octocat/Hello-World/compare/master...topic",
                                                                                                            "html_url": "https://github.com/octocat/Hello-World/compare/master...topic",
                                                                                                            "permalink_url": "https://github.com/octocat/Hello-World/compare/octocat:bbcd538c8e72b8c175046e27cc8f907076331401...octocat:0328041d1152db8ae77652d1618a02e57f745f17",
                                                                                                            "diff_url": "https://github.com/octocat/Hello-World/compare/master...topic.diff",
                                                                                                            "patch_url": "https://github.com/octocat/Hello-World/compare/master...topic.patch",
                                                                                                            "base_commit": {
                                                                                                              "url": "https://api.github.com/repos/octocat/Hello-World/commits/6dcb09b5b57875f334f61aebed695e2e4193db5e",
                                                                                                              "sha": "6dcb09b5b57875f334f61aebed695e2e4193db5e",
                                                                                                              "html_url": "https://github.com/octocat/Hello-World/commit/6dcb09b5b57875f334f61aebed695e2e4193db5e",
                                                                                                              "comments_url": "https://api.github.com/repos/octocat/Hello-World/commits/6dcb09b5b57875f334f61aebed695e2e4193db5e/comments",
                                                                                                              "commit": {
                                                                                                                "url": "https://api.github.com/repos/octocat/Hello-World/git/commits/6dcb09b5b57875f334f61aebed695e2e4193db5e",
                                                                                                                "author": {
                                                                                                                  "name": "Monalisa Octocat",
                                                                                                                  "email": "support@github.com",
                                                                                                                  "date": "2011-04-14T16:00:49Z"
                                                                                                                },
                                                                                                                "committer": {
                                                                                                                  "name": "Monalisa Octocat",
                                                                                                                  "email": "support@github.com",
                                                                                                                  "date": "2011-04-14T16:00:49Z"
                                                                                                                },
                                                                                                                "message": "Fix all the bugs",
                                                                                                                "tree": {
                                                                                                                  "url": "https://api.github.com/repos/octocat/Hello-World/tree/6dcb09b5b57875f334f61aebed695e2e4193db5e",
                                                                                                                  "sha": "6dcb09b5b57875f334f61aebed695e2e4193db5e"
                                                                                                                },
                                                                                                                "comment_count": 0,
                                                                                                                "verification": {
                                                                                                                  "verified": false,
                                                                                                                  "reason": "unsigned",
                                                                                                                  "signature": null,
                                                                                                                  "payload": null
                                                                                                                }
                                                                                                              },
                                                                                                              "author": {
                                                                                                                "login": "octocat",
                                                                                                                "id": 1,
                                                                                                                "avatar_url": "https://github.com/images/error/octocat_happy.gif",
                                                                                                                "gravatar_id": "",
                                                                                                                "url": "https://api.github.com/users/octocat",
                                                                                                                "html_url": "https://github.com/octocat",
                                                                                                                "followers_url": "https://api.github.com/users/octocat/followers",
                                                                                                                "following_url": "https://api.github.com/users/octocat/following{/other_user}",
                                                                                                                "gists_url": "https://api.github.com/users/octocat/gists{/gist_id}",
                                                                                                                "starred_url": "https://api.github.com/users/octocat/starred{/owner}{/repo}",
                                                                                                                "subscriptions_url": "https://api.github.com/users/octocat/subscriptions",
                                                                                                                "organizations_url": "https://api.github.com/users/octocat/orgs",
                                                                                                                "repos_url": "https://api.github.com/users/octocat/repos",
                                                                                                                "events_url": "https://api.github.com/users/octocat/events{/privacy}",
                                                                                                                "received_events_url": "https://api.github.com/users/octocat/received_events",
                                                                                                                "type": "User",
                                                                                                                "site_admin": false
                                                                                                              },
                                                                                                              "committer": {
                                                                                                                "login": "octocat",
                                                                                                                "id": 1,
                                                                                                                "avatar_url": "https://github.com/images/error/octocat_happy.gif",
                                                                                                                "gravatar_id": "",
                                                                                                                "url": "https://api.github.com/users/octocat",
                                                                                                                "html_url": "https://github.com/octocat",
                                                                                                                "followers_url": "https://api.github.com/users/octocat/followers",
                                                                                                                "following_url": "https://api.github.com/users/octocat/following{/other_user}",
                                                                                                                "gists_url": "https://api.github.com/users/octocat/gists{/gist_id}",
                                                                                                                "starred_url": "https://api.github.com/users/octocat/starred{/owner}{/repo}",
                                                                                                                "subscriptions_url": "https://api.github.com/users/octocat/subscriptions",
                                                                                                                "organizations_url": "https://api.github.com/users/octocat/orgs",
                                                                                                                "repos_url": "https://api.github.com/users/octocat/repos",
                                                                                                                "events_url": "https://api.github.com/users/octocat/events{/privacy}",
                                                                                                                "received_events_url": "https://api.github.com/users/octocat/received_events",
                                                                                                                "type": "User",
                                                                                                                "site_admin": false
                                                                                                              },
                                                                                                              "parents": [
                                                                                                                {
                                                                                                                  "url": "https://api.github.com/repos/octocat/Hello-World/commits/6dcb09b5b57875f334f61aebed695e2e4193db5e",
                                                                                                                  "sha": "6dcb09b5b57875f334f61aebed695e2e4193db5e"
                                                                                                                }
                                                                                                              ]
                                                                                                            },
                                                                                                            "merge_base_commit": {
                                                                                                              "url": "https://api.github.com/repos/octocat/Hello-World/commits/6dcb09b5b57875f334f61aebed695e2e4193db5e",
                                                                                                              "sha": "6dcb09b5b57875f334f61aebed695e2e4193db5e",
                                                                                                              "html_url": "https://github.com/octocat/Hello-World/commit/6dcb09b5b57875f334f61aebed695e2e4193db5e",
                                                                                                              "comments_url": "https://api.github.com/repos/octocat/Hello-World/commits/6dcb09b5b57875f334f61aebed695e2e4193db5e/comments",
                                                                                                              "commit": {
                                                                                                                "url": "https://api.github.com/repos/octocat/Hello-World/git/commits/6dcb09b5b57875f334f61aebed695e2e4193db5e",
                                                                                                                "author": {
                                                                                                                  "name": "Monalisa Octocat",
                                                                                                                  "email": "support@github.com",
                                                                                                                  "date": "2011-04-14T16:00:49Z"
                                                                                                                },
                                                                                                                "committer": {
                                                                                                                  "name": "Monalisa Octocat",
                                                                                                                  "email": "support@github.com",
                                                                                                                  "date": "2011-04-14T16:00:49Z"
                                                                                                                },
                                                                                                                "message": "Fix all the bugs",
                                                                                                                "tree": {
                                                                                                                  "url": "https://api.github.com/repos/octocat/Hello-World/tree/6dcb09b5b57875f334f61aebed695e2e4193db5e",
                                                                                                                  "sha": "6dcb09b5b57875f334f61aebed695e2e4193db5e"
                                                                                                                },
                                                                                                                "comment_count": 0,
                                                                                                                "verification": {
                                                                                                                  "verified": false,
                                                                                                                  "reason": "unsigned",
                                                                                                                  "signature": null,
                                                                                                                  "payload": null
                                                                                                                }
                                                                                                              },
                                                                                                              "author": {
                                                                                                                "login": "octocat",
                                                                                                                "id": 1,
                                                                                                                "avatar_url": "https://github.com/images/error/octocat_happy.gif",
                                                                                                                "gravatar_id": "",
                                                                                                                "url": "https://api.github.com/users/octocat",
                                                                                                                "html_url": "https://github.com/octocat",
                                                                                                                "followers_url": "https://api.github.com/users/octocat/followers",
                                                                                                                "following_url": "https://api.github.com/users/octocat/following{/other_user}",
                                                                                                                "gists_url": "https://api.github.com/users/octocat/gists{/gist_id}",
                                                                                                                "starred_url": "https://api.github.com/users/octocat/starred{/owner}{/repo}",
                                                                                                                "subscriptions_url": "https://api.github.com/users/octocat/subscriptions",
                                                                                                                "organizations_url": "https://api.github.com/users/octocat/orgs",
                                                                                                                "repos_url": "https://api.github.com/users/octocat/repos",
                                                                                                                "events_url": "https://api.github.com/users/octocat/events{/privacy}",
                                                                                                                "received_events_url": "https://api.github.com/users/octocat/received_events",
                                                                                                                "type": "User",
                                                                                                                "site_admin": false
                                                                                                              },
                                                                                                              "committer": {
                                                                                                                "login": "octocat",
                                                                                                                "id": 1,
                                                                                                                "avatar_url": "https://github.com/images/error/octocat_happy.gif",
                                                                                                                "gravatar_id": "",
                                                                                                                "url": "https://api.github.com/users/octocat",
                                                                                                                "html_url": "https://github.com/octocat",
                                                                                                                "followers_url": "https://api.github.com/users/octocat/followers",
                                                                                                                "following_url": "https://api.github.com/users/octocat/following{/other_user}",
                                                                                                                "gists_url": "https://api.github.com/users/octocat/gists{/gist_id}",
                                                                                                                "starred_url": "https://api.github.com/users/octocat/starred{/owner}{/repo}",
                                                                                                                "subscriptions_url": "https://api.github.com/users/octocat/subscriptions",
                                                                                                                "organizations_url": "https://api.github.com/users/octocat/orgs",
                                                                                                                "repos_url": "https://api.github.com/users/octocat/repos",
                                                                                                                "events_url": "https://api.github.com/users/octocat/events{/privacy}",
                                                                                                                "received_events_url": "https://api.github.com/users/octocat/received_events",
                                                                                                                "type": "User",
                                                                                                                "site_admin": false
                                                                                                              },
                                                                                                              "parents": [
                                                                                                                {
                                                                                                                  "url": "https://api.github.com/repos/octocat/Hello-World/commits/6dcb09b5b57875f334f61aebed695e2e4193db5e",
                                                                                                                  "sha": "6dcb09b5b57875f334f61aebed695e2e4193db5e"
                                                                                                                }
                                                                                                              ]
                                                                                                            },
                                                                                                            "status": "behind",
                                                                                                            "ahead_by": 1,
                                                                                                            "behind_by": 2,
                                                                                                            "total_commits": 1,
                                                                                                            "commits": [
                                                                                                              {
                                                                                                                "url": "https://api.github.com/repos/octocat/Hello-World/commits/6dcb09b5b57875f334f61aebed695e2e4193db5e",
                                                                                                                "sha": "6dcb09b5b57875f334f61aebed695e2e4193db5e",
                                                                                                                "html_url": "https://github.com/octocat/Hello-World/commit/6dcb09b5b57875f334f61aebed695e2e4193db5e",
                                                                                                                "comments_url": "https://api.github.com/repos/octocat/Hello-World/commits/6dcb09b5b57875f334f61aebed695e2e4193db5e/comments",
                                                                                                                "commit": {
                                                                                                                  "url": "https://api.github.com/repos/octocat/Hello-World/git/commits/6dcb09b5b57875f334f61aebed695e2e4193db5e",
                                                                                                                  "author": {
                                                                                                                    "name": "Monalisa Octocat",
                                                                                                                    "email": "support@github.com",
                                                                                                                    "date": "2011-04-14T16:00:49Z"
                                                                                                                  },
                                                                                                                  "committer": {
                                                                                                                    "name": "Monalisa Octocat",
                                                                                                                    "email": "support@github.com",
                                                                                                                    "date": "2011-04-14T16:00:49Z"
                                                                                                                  },
                                                                                                                  "message": "Fix all the bugs",
                                                                                                                  "tree": {
                                                                                                                    "url": "https://api.github.com/repos/octocat/Hello-World/tree/6dcb09b5b57875f334f61aebed695e2e4193db5e",
                                                                                                                    "sha": "6dcb09b5b57875f334f61aebed695e2e4193db5e"
                                                                                                                  },
                                                                                                                  "comment_count": 0,
                                                                                                                  "verification": {
                                                                                                                    "verified": false,
                                                                                                                    "reason": "unsigned",
                                                                                                                    "signature": null,
                                                                                                                    "payload": null
                                                                                                                  }
                                                                                                                },
                                                                                                                "author": {
                                                                                                                  "login": "octocat",
                                                                                                                  "id": 1,
                                                                                                                  "avatar_url": "https://github.com/images/error/octocat_happy.gif",
                                                                                                                  "gravatar_id": "",
                                                                                                                  "url": "https://api.github.com/users/octocat",
                                                                                                                  "html_url": "https://github.com/octocat",
                                                                                                                  "followers_url": "https://api.github.com/users/octocat/followers",
                                                                                                                  "following_url": "https://api.github.com/users/octocat/following{/other_user}",
                                                                                                                  "gists_url": "https://api.github.com/users/octocat/gists{/gist_id}",
                                                                                                                  "starred_url": "https://api.github.com/users/octocat/starred{/owner}{/repo}",
                                                                                                                  "subscriptions_url": "https://api.github.com/users/octocat/subscriptions",
                                                                                                                  "organizations_url": "https://api.github.com/users/octocat/orgs",
                                                                                                                  "repos_url": "https://api.github.com/users/octocat/repos",
                                                                                                                  "events_url": "https://api.github.com/users/octocat/events{/privacy}",
                                                                                                                  "received_events_url": "https://api.github.com/users/octocat/received_events",
                                                                                                                  "type": "User",
                                                                                                                  "site_admin": false
                                                                                                                },
                                                                                                                "committer": {
                                                                                                                  "login": "octocat",
                                                                                                                  "id": 1,
                                                                                                                  "avatar_url": "https://github.com/images/error/octocat_happy.gif",
                                                                                                                  "gravatar_id": "",
                                                                                                                  "url": "https://api.github.com/users/octocat",
                                                                                                                  "html_url": "https://github.com/octocat",
                                                                                                                  "followers_url": "https://api.github.com/users/octocat/followers",
                                                                                                                  "following_url": "https://api.github.com/users/octocat/following{/other_user}",
                                                                                                                  "gists_url": "https://api.github.com/users/octocat/gists{/gist_id}",
                                                                                                                  "starred_url": "https://api.github.com/users/octocat/starred{/owner}{/repo}",
                                                                                                                  "subscriptions_url": "https://api.github.com/users/octocat/subscriptions",
                                                                                                                  "organizations_url": "https://api.github.com/users/octocat/orgs",
                                                                                                                  "repos_url": "https://api.github.com/users/octocat/repos",
                                                                                                                  "events_url": "https://api.github.com/users/octocat/events{/privacy}",
                                                                                                                  "received_events_url": "https://api.github.com/users/octocat/received_events",
                                                                                                                  "type": "User",
                                                                                                                  "site_admin": false
                                                                                                                },
                                                                                                                "parents": [
                                                                                                                  {
                                                                                                                    "url": "https://api.github.com/repos/octocat/Hello-World/commits/6dcb09b5b57875f334f61aebed695e2e4193db5e",
                                                                                                                    "sha": "6dcb09b5b57875f334f61aebed695e2e4193db5e"
                                                                                                                  }
                                                                                                                ]
                                                                                                              }
                                                                                                            ],
                                                                                                            "files": [
                                                                                                              {
                                                                                                                "sha": "bbcd538c8e72b8c175046e27cc8f907076331401",
                                                                                                                "filename": "file1.txt",
                                                                                                                "status": "added",
                                                                                                                "additions": 103,
                                                                                                                "deletions": 21,
                                                                                                                "changes": 124,
                                                                                                                "blob_url": "https://github.com/octocat/Hello-World/blob/6dcb09b5b57875f334f61aebed695e2e4193db5e/file1.txt",
                                                                                                                "raw_url": "https://github.com/octocat/Hello-World/raw/6dcb09b5b57875f334f61aebed695e2e4193db5e/file1.txt",
                                                                                                                "contents_url": "https://api.github.com/repos/octocat/Hello-World/contents/file1.txt?ref=6dcb09b5b57875f334f61aebed695e2e4193db5e",
                                                                                                                "patch": "@@ -132,7 +132,7 @@ module Test @@ -1000,7 +1000,7 @@ module Test"
                                                                                                              }
                                                                                                            ]
                                                                                                          }
                                                                                                          

                                                                                                          Working with large comparisons

                                                                                                          The response will include a comparison of up to 250 commits. If you are working with a larger commit range, you can use the Commit List API to enumerate all commits in the range.

                                                                                                          For comparisons with extremely large diffs, you may receive an error response indicating that the diff took too long to generate. You can typically resolve this error by using a smaller commit range.

                                                                                                          Commit signature verification

                                                                                                          GET /repos/:owner/:repo/commits/:sha
                                                                                                          

                                                                                                          Response

                                                                                                          Status: 200 OK
                                                                                                          
                                                                                                          {
                                                                                                            "url": "https://api.github.com/repos/octocat/Hello-World/commits/6dcb09b5b57875f334f61aebed695e2e4193db5e",
                                                                                                            "sha": "6dcb09b5b57875f334f61aebed695e2e4193db5e",
                                                                                                            "html_url": "https://github.com/octocat/Hello-World/commit/6dcb09b5b57875f334f61aebed695e2e4193db5e",
                                                                                                            "comments_url": "https://api.github.com/repos/octocat/Hello-World/commits/6dcb09b5b57875f334f61aebed695e2e4193db5e/comments",
                                                                                                            "commit": {
                                                                                                              "url": "https://api.github.com/repos/octocat/Hello-World/git/commits/6dcb09b5b57875f334f61aebed695e2e4193db5e",
                                                                                                              "author": {
                                                                                                                "name": "Monalisa Octocat",
                                                                                                                "email": "support@github.com",
                                                                                                                "date": "2011-04-14T16:00:49Z"
                                                                                                              },
                                                                                                              "committer": {
                                                                                                                "name": "Monalisa Octocat",
                                                                                                                "email": "support@github.com",
                                                                                                                "date": "2011-04-14T16:00:49Z"
                                                                                                              },
                                                                                                              "message": "Fix all the bugs",
                                                                                                              "tree": {
                                                                                                                "url": "https://api.github.com/repos/octocat/Hello-World/tree/6dcb09b5b57875f334f61aebed695e2e4193db5e",
                                                                                                                "sha": "6dcb09b5b57875f334f61aebed695e2e4193db5e"
                                                                                                              },
                                                                                                              "comment_count": 0,
                                                                                                              "verification": {
                                                                                                                "verified": false,
                                                                                                                "reason": "unsigned",
                                                                                                                "signature": null,
                                                                                                                "payload": null
                                                                                                              }
                                                                                                            },
                                                                                                            "author": {
                                                                                                              "login": "octocat",
                                                                                                              "id": 1,
                                                                                                              "avatar_url": "https://github.com/images/error/octocat_happy.gif",
                                                                                                              "gravatar_id": "",
                                                                                                              "url": "https://api.github.com/users/octocat",
                                                                                                              "html_url": "https://github.com/octocat",
                                                                                                              "followers_url": "https://api.github.com/users/octocat/followers",
                                                                                                              "following_url": "https://api.github.com/users/octocat/following{/other_user}",
                                                                                                              "gists_url": "https://api.github.com/users/octocat/gists{/gist_id}",
                                                                                                              "starred_url": "https://api.github.com/users/octocat/starred{/owner}{/repo}",
                                                                                                              "subscriptions_url": "https://api.github.com/users/octocat/subscriptions",
                                                                                                              "organizations_url": "https://api.github.com/users/octocat/orgs",
                                                                                                              "repos_url": "https://api.github.com/users/octocat/repos",
                                                                                                              "events_url": "https://api.github.com/users/octocat/events{/privacy}",
                                                                                                              "received_events_url": "https://api.github.com/users/octocat/received_events",
                                                                                                              "type": "User",
                                                                                                              "site_admin": false
                                                                                                            },
                                                                                                            "committer": {
                                                                                                              "login": "octocat",
                                                                                                              "id": 1,
                                                                                                              "avatar_url": "https://github.com/images/error/octocat_happy.gif",
                                                                                                              "gravatar_id": "",
                                                                                                              "url": "https://api.github.com/users/octocat",
                                                                                                              "html_url": "https://github.com/octocat",
                                                                                                              "followers_url": "https://api.github.com/users/octocat/followers",
                                                                                                              "following_url": "https://api.github.com/users/octocat/following{/other_user}",
                                                                                                              "gists_url": "https://api.github.com/users/octocat/gists{/gist_id}",
                                                                                                              "starred_url": "https://api.github.com/users/octocat/starred{/owner}{/repo}",
                                                                                                              "subscriptions_url": "https://api.github.com/users/octocat/subscriptions",
                                                                                                              "organizations_url": "https://api.github.com/users/octocat/orgs",
                                                                                                              "repos_url": "https://api.github.com/users/octocat/repos",
                                                                                                              "events_url": "https://api.github.com/users/octocat/events{/privacy}",
                                                                                                              "received_events_url": "https://api.github.com/users/octocat/received_events",
                                                                                                              "type": "User",
                                                                                                              "site_admin": false
                                                                                                            },
                                                                                                            "parents": [
                                                                                                              {
                                                                                                                "url": "https://api.github.com/repos/octocat/Hello-World/commits/6dcb09b5b57875f334f61aebed695e2e4193db5e",
                                                                                                                "sha": "6dcb09b5b57875f334f61aebed695e2e4193db5e"
                                                                                                              }
                                                                                                            ]
                                                                                                          }
                                                                                                          

                                                                                                          The verification object

                                                                                                          The response will include a verification field whose value is an object describing the result of verifying the commit's signature. The following fields are included in the verification object:

                                                                                                          Name Type Description
                                                                                                          verified boolean Does GitHub consider the signature in this commit to be verified?
                                                                                                          reason string The reason for verified value. Possible values and their meanings are enumerated in the table below.
                                                                                                          signature string The signature that was extracted from the commit.
                                                                                                          payload string The value that was signed.

                                                                                                          The reason field

                                                                                                          The following are possible reasons that may be included in the verification object:

                                                                                                          Value Description
                                                                                                          expired_key The key that made the signature is expired.
                                                                                                          not_signing_key The "signing" flag is not among the usage flags in the GPG key that made the signature.
                                                                                                          gpgverify_error There was an error communicating with the signature-verification service.
                                                                                                          gpgverify_unavailable The signature-verification service is currently unavailable.
                                                                                                          unsigned The object does not include a signature.
                                                                                                          unkown_signature_type A non-PGP signature was found in the commit.
                                                                                                          no_user No user was associated with the committer email address in the commit.
                                                                                                          unverified_email The committer email address in the commit was associated with a user, but the email address is not verified on her/his account.
                                                                                                          bad_email The committer email address in the commit is not included in the identities of the PGP key that made the signature.
                                                                                                          unknown_key The key that made the signature has not been registered with any user's account.
                                                                                                          malformed_signature There was an error parsing the signature.
                                                                                                          invalid The signature could not be cryptographically verified using the key whose key-id was found in the signature.
                                                                                                          valid None of the above errors applied, so the signature is considered to be verified.
                                                                                                          tmp/developer.github.com/v3/repos/community/index.html Community | GitHub Developer Guide

                                                                                                          Community Profile

                                                                                                          We're currently offering a preview of the Community Profile API (also known as community health).

                                                                                                          To access the API during the preview period, you must provide a custom media type in the Accept header:

                                                                                                          application/vnd.github.black-panther-preview+json
                                                                                                          

                                                                                                          Retrieve community profile metrics

                                                                                                          GET /repos/:owner/:name/community/profile
                                                                                                          

                                                                                                          This endpoint will return all community profile metrics, including an overall health score, repository description, the presence of documentation, detected code of conduct, detected license, and the presence of ISSUE_TEMPLATE, PULL_REQUEST_TEMPLATE, README, and CONTRIBUTING files.

                                                                                                          Response

                                                                                                          Status: 200 OK
                                                                                                          
                                                                                                          {
                                                                                                            "health_percentage": 100,
                                                                                                            "description": "My first repository on GitHub!",
                                                                                                            "documentation": true,
                                                                                                            "files": {
                                                                                                              "code_of_conduct": {
                                                                                                                "name": "Contributor Covenant",
                                                                                                                "key": "contributor_covenant",
                                                                                                                "url": "https://api.github.com/codes_of_conduct/contributor_covenant",
                                                                                                                "html_url": "https://github.com/octocat/Hello-World`/blob/master/CODE_OF_CONDUCT.md"
                                                                                                              },
                                                                                                              "contributing": {
                                                                                                                "url": "https://api.github.com/repos/octocat/Hello-World/contents/CONTRIBUTING",
                                                                                                                "html_url": "https://github.com/octocat/Hello-World/blob/master/CONTRIBUTING"
                                                                                                              },
                                                                                                              "issue_template": {
                                                                                                                "url": "https://api.github.com/repos/octocat/Hello-World/contents/ISSUE_TEMPLATE",
                                                                                                                "html_url": "https://github.com/octocat/Hello-World/blob/master/ISSUE_TEMPLATE"
                                                                                                              },
                                                                                                              "pull_request_template": {
                                                                                                                "url": "https://api.github.com/repos/octocat/Hello-World/contents/PULL_REQUEST_TEMPLATE",
                                                                                                                "html_url": "https://github.com/octocat/Hello-World/blob/master/PULL_REQUEST_TEMPLATE"
                                                                                                              },
                                                                                                              "license": {
                                                                                                                "name": "MIT License",
                                                                                                                "key": "mit",
                                                                                                                "spdx_id": "MIT",
                                                                                                                "url": "https://api.github.com/licenses/mit",
                                                                                                                "html_url": "https://github.com/octocat/Hello-World/blob/master/LICENSE"
                                                                                                              },
                                                                                                              "readme": {
                                                                                                                "url": "https://api.github.com/repos/octocat/Hello-World/contents/README.md",
                                                                                                                "html_url": "https://github.com/octocat/Hello-World/blob/master/README.md"
                                                                                                              }
                                                                                                            },
                                                                                                            "updated_at": "2017-02-28T19:09:29Z"
                                                                                                          }
                                                                                                          
                                                                                                          tmp/developer.github.com/v3/repos/contents/index.html Contents | GitHub Developer Guide

                                                                                                          Contents

                                                                                                          These API methods let you retrieve the contents of files within a repository as Base64 encoded content. See media types for requesting the raw format or rendered HTML (when supported).

                                                                                                          Get the README

                                                                                                          This method returns the preferred README for a repository.

                                                                                                          GET /repos/:owner/:repo/readme
                                                                                                          

                                                                                                          READMEs support custom media types for retrieving the raw content or rendered HTML.

                                                                                                          Parameters

                                                                                                          Name Type Description
                                                                                                          ref string The name of the commit/branch/tag. Default: the repository’s default branch (usually master)

                                                                                                          Response

                                                                                                          Status: 200 OK
                                                                                                          
                                                                                                          {
                                                                                                            "type": "file",
                                                                                                            "encoding": "base64",
                                                                                                            "size": 5362,
                                                                                                            "name": "README.md",
                                                                                                            "path": "README.md",
                                                                                                            "content": "encoded content ...",
                                                                                                            "sha": "3d21ec53a331a6f037a91c368710b99387d012c1",
                                                                                                            "url": "https://api.github.com/repos/octokit/octokit.rb/contents/README.md",
                                                                                                            "git_url": "https://api.github.com/repos/octokit/octokit.rb/git/blobs/3d21ec53a331a6f037a91c368710b99387d012c1",
                                                                                                            "html_url": "https://github.com/octokit/octokit.rb/blob/master/README.md",
                                                                                                            "download_url": "https://raw.githubusercontent.com/octokit/octokit.rb/master/README.md",
                                                                                                            "_links": {
                                                                                                              "git": "https://api.github.com/repos/octokit/octokit.rb/git/blobs/3d21ec53a331a6f037a91c368710b99387d012c1",
                                                                                                              "self": "https://api.github.com/repos/octokit/octokit.rb/contents/README.md",
                                                                                                              "html": "https://github.com/octokit/octokit.rb/blob/master/README.md"
                                                                                                            }
                                                                                                          }
                                                                                                          

                                                                                                          Get contents

                                                                                                          This method returns the contents of a file or directory in a repository.

                                                                                                          GET /repos/:owner/:repo/contents/:path
                                                                                                          

                                                                                                          Files and symlinks support a custom media type for retrieving the raw content or rendered HTML (when supported). All content types support a custom media type to ensure the content is returned in a consistent object format.

                                                                                                          Note:

                                                                                                          • To get a repository's contents recursively, you can recursively get the tree.
                                                                                                          • This API has an upper limit of 1,000 files for a directory. If you need to retrieve more files, use the Git Trees API.
                                                                                                          • This API supports files up to 1 megabyte in size.

                                                                                                          Parameters

                                                                                                          Name Type Description
                                                                                                          path string The content path.
                                                                                                          ref string The name of the commit/branch/tag. Default: the repository’s default branch (usually master)

                                                                                                          Response if content is a file

                                                                                                          Status: 200 OK
                                                                                                          
                                                                                                          {
                                                                                                            "type": "file",
                                                                                                            "encoding": "base64",
                                                                                                            "size": 5362,
                                                                                                            "name": "README.md",
                                                                                                            "path": "README.md",
                                                                                                            "content": "encoded content ...",
                                                                                                            "sha": "3d21ec53a331a6f037a91c368710b99387d012c1",
                                                                                                            "url": "https://api.github.com/repos/octokit/octokit.rb/contents/README.md",
                                                                                                            "git_url": "https://api.github.com/repos/octokit/octokit.rb/git/blobs/3d21ec53a331a6f037a91c368710b99387d012c1",
                                                                                                            "html_url": "https://github.com/octokit/octokit.rb/blob/master/README.md",
                                                                                                            "download_url": "https://raw.githubusercontent.com/octokit/octokit.rb/master/README.md",
                                                                                                            "_links": {
                                                                                                              "git": "https://api.github.com/repos/octokit/octokit.rb/git/blobs/3d21ec53a331a6f037a91c368710b99387d012c1",
                                                                                                              "self": "https://api.github.com/repos/octokit/octokit.rb/contents/README.md",
                                                                                                              "html": "https://github.com/octokit/octokit.rb/blob/master/README.md"
                                                                                                            }
                                                                                                          }
                                                                                                          

                                                                                                          Response if content is a directory

                                                                                                          The response will be an array of objects, one object for each item in the directory.

                                                                                                          When listing the contents of a directory, submodules have their "type" specified as "file". Logically, the value should be "submodule". This behavior exists in API v3 for backwards compatibility purposes. In the next major version of the API, the type will be returned as "submodule".

                                                                                                          Status: 200 OK
                                                                                                          
                                                                                                          [
                                                                                                            {
                                                                                                              "type": "file",
                                                                                                              "size": 625,
                                                                                                              "name": "octokit.rb",
                                                                                                              "path": "lib/octokit.rb",
                                                                                                              "sha": "fff6fe3a23bf1c8ea0692b4a883af99bee26fd3b",
                                                                                                              "url": "https://api.github.com/repos/octokit/octokit.rb/contents/lib/octokit.rb",
                                                                                                              "git_url": "https://api.github.com/repos/octokit/octokit.rb/git/blobs/fff6fe3a23bf1c8ea0692b4a883af99bee26fd3b",
                                                                                                              "html_url": "https://github.com/octokit/octokit.rb/blob/master/lib/octokit.rb",
                                                                                                              "download_url": "https://raw.githubusercontent.com/octokit/octokit.rb/master/lib/octokit.rb",
                                                                                                              "_links": {
                                                                                                                "self": "https://api.github.com/repos/octokit/octokit.rb/contents/lib/octokit.rb",
                                                                                                                "git": "https://api.github.com/repos/octokit/octokit.rb/git/blobs/fff6fe3a23bf1c8ea0692b4a883af99bee26fd3b",
                                                                                                                "html": "https://github.com/octokit/octokit.rb/blob/master/lib/octokit.rb"
                                                                                                              }
                                                                                                            },
                                                                                                            {
                                                                                                              "type": "dir",
                                                                                                              "size": 0,
                                                                                                              "name": "octokit",
                                                                                                              "path": "lib/octokit",
                                                                                                              "sha": "a84d88e7554fc1fa21bcbc4efae3c782a70d2b9d",
                                                                                                              "url": "https://api.github.com/repos/octokit/octokit.rb/contents/lib/octokit",
                                                                                                              "git_url": "https://api.github.com/repos/octokit/octokit.rb/git/trees/a84d88e7554fc1fa21bcbc4efae3c782a70d2b9d",
                                                                                                              "html_url": "https://github.com/octokit/octokit.rb/tree/master/lib/octokit",
                                                                                                              "download_url": null,
                                                                                                              "_links": {
                                                                                                                "self": "https://api.github.com/repos/octokit/octokit.rb/contents/lib/octokit",
                                                                                                                "git": "https://api.github.com/repos/octokit/octokit.rb/git/trees/a84d88e7554fc1fa21bcbc4efae3c782a70d2b9d",
                                                                                                                "html": "https://github.com/octokit/octokit.rb/tree/master/lib/octokit"
                                                                                                              }
                                                                                                            }
                                                                                                          ]
                                                                                                          

                                                                                                          Response if content is a symlink

                                                                                                          If the requested :path points to a symlink, and the symlink's target is a normal file in the repository, then the API responds with the content of the file (in the format shown above).

                                                                                                          Otherwise, the API responds with an object describing the symlink itself:

                                                                                                          Status: 200 OK
                                                                                                          
                                                                                                          {
                                                                                                            "type": "symlink",
                                                                                                            "target": "/path/to/symlink/target",
                                                                                                            "size": 23,
                                                                                                            "name": "some-symlink",
                                                                                                            "path": "bin/some-symlink",
                                                                                                            "sha": "452a98979c88e093d682cab404a3ec82babebb48",
                                                                                                            "url": "https://api.github.com/repos/octokit/octokit.rb/contents/bin/some-symlink",
                                                                                                            "git_url": "https://api.github.com/repos/octokit/octokit.rb/git/blobs/452a98979c88e093d682cab404a3ec82babebb48",
                                                                                                            "html_url": "https://github.com/octokit/octokit.rb/blob/master/bin/some-symlink",
                                                                                                            "download_url": "https://raw.githubusercontent.com/octokit/octokit.rb/master/bin/some-symlink",
                                                                                                            "_links": {
                                                                                                              "git": "https://api.github.com/repos/octokit/octokit.rb/git/blobs/452a98979c88e093d682cab404a3ec82babebb48",
                                                                                                              "self": "https://api.github.com/repos/octokit/octokit.rb/contents/bin/some-symlink",
                                                                                                              "html": "https://github.com/octokit/octokit.rb/blob/master/bin/some-symlink"
                                                                                                            }
                                                                                                          }
                                                                                                          

                                                                                                          Response if content is a submodule

                                                                                                          The submodule_git_url identifies the location of the submodule repository, and the sha identifies a specific commit within the submodule repository. Git uses the given URL when cloning the submodule repository, and checks out the submodule at that specific commit.

                                                                                                          If the submodule repository is not hosted on github.com, the Git URLs (git_url and _links["git"]) and the github.com URLs (html_url and _links["html"]) will have null values.

                                                                                                          Status: 200 OK
                                                                                                          
                                                                                                          {
                                                                                                            "type": "submodule",
                                                                                                            "submodule_git_url": "git://github.com/jquery/qunit.git",
                                                                                                            "size": 0,
                                                                                                            "name": "qunit",
                                                                                                            "path": "test/qunit",
                                                                                                            "sha": "6ca3721222109997540bd6d9ccd396902e0ad2f9",
                                                                                                            "url": "https://api.github.com/repos/jquery/jquery/contents/test/qunit?ref=master",
                                                                                                            "git_url": "https://api.github.com/repos/jquery/qunit/git/trees/6ca3721222109997540bd6d9ccd396902e0ad2f9",
                                                                                                            "html_url": "https://github.com/jquery/qunit/tree/6ca3721222109997540bd6d9ccd396902e0ad2f9",
                                                                                                            "download_url": null,
                                                                                                            "_links": {
                                                                                                              "git": "https://api.github.com/repos/jquery/qunit/git/trees/6ca3721222109997540bd6d9ccd396902e0ad2f9",
                                                                                                              "self": "https://api.github.com/repos/jquery/jquery/contents/test/qunit?ref=master",
                                                                                                              "html": "https://github.com/jquery/qunit/tree/6ca3721222109997540bd6d9ccd396902e0ad2f9"
                                                                                                            }
                                                                                                          }
                                                                                                          

                                                                                                          Create a file

                                                                                                          This method creates a new file in a repository

                                                                                                          PUT /repos/:owner/:repo/contents/:path
                                                                                                          

                                                                                                          Parameters

                                                                                                          Name Type Description
                                                                                                          path string Required. The content path.
                                                                                                          message string Required. The commit message.
                                                                                                          content string Required. The new file content, Base64 encoded.
                                                                                                          branch string The branch name. Default: the repository’s default branch (usually master)

                                                                                                          Optional Parameters

                                                                                                          You can provide an additional committer parameter, which is an object containing information about the committer. Or, you can provide an author parameter, which is an object containing information about the author.

                                                                                                          The author section is optional and is filled in with the committer information if omitted. If the committer information is omitted, the authenticated user's information is used.

                                                                                                          You must provide values for both name and email, whether you choose to use author or committer. Otherwise, you'll receive a 422 status code.

                                                                                                          Both the author and committer parameters have the same keys:

                                                                                                          Name Type Description
                                                                                                          name string The name of the author (or committer) of the commit
                                                                                                          email string The email of the author (or committer) of the commit

                                                                                                          Example Input

                                                                                                          {
                                                                                                            "message": "my commit message",
                                                                                                            "committer": {
                                                                                                              "name": "Scott Chacon",
                                                                                                              "email": "schacon@gmail.com"
                                                                                                            },
                                                                                                            "content": "bXkgbmV3IGZpbGUgY29udGVudHM="
                                                                                                          }
                                                                                                          

                                                                                                          Response

                                                                                                          Status: 201 Created
                                                                                                          
                                                                                                          {
                                                                                                            "content": {
                                                                                                              "name": "hello.txt",
                                                                                                              "path": "notes/hello.txt",
                                                                                                              "sha": "95b966ae1c166bd92f8ae7d1c313e738c731dfc3",
                                                                                                              "size": 9,
                                                                                                              "url": "https://api.github.com/repos/octocat/Hello-World/contents/notes/hello.txt",
                                                                                                              "html_url": "https://github.com/octocat/Hello-World/blob/master/notes/hello.txt",
                                                                                                              "git_url": "https://api.github.com/repos/octocat/Hello-World/git/blobs/95b966ae1c166bd92f8ae7d1c313e738c731dfc3",
                                                                                                              "download_url": "https://raw.githubusercontent.com/octocat/HelloWorld/master/notes/hello.txt",
                                                                                                              "type": "file",
                                                                                                              "_links": {
                                                                                                                "self": "https://api.github.com/repos/octocat/Hello-World/contents/notes/hello.txt",
                                                                                                                "git": "https://api.github.com/repos/octocat/Hello-World/git/blobs/95b966ae1c166bd92f8ae7d1c313e738c731dfc3",
                                                                                                                "html": "https://github.com/octocat/Hello-World/blob/master/notes/hello.txt"
                                                                                                              }
                                                                                                            },
                                                                                                            "commit": {
                                                                                                              "sha": "7638417db6d59f3c431d3e1f261cc637155684cd",
                                                                                                              "url": "https://api.github.com/repos/octocat/Hello-World/git/commits/7638417db6d59f3c431d3e1f261cc637155684cd",
                                                                                                              "html_url": "https://github.com/octocat/Hello-World/git/commit/7638417db6d59f3c431d3e1f261cc637155684cd",
                                                                                                              "author": {
                                                                                                                "date": "2014-11-07T22:01:45Z",
                                                                                                                "name": "Scott Chacon",
                                                                                                                "email": "schacon@gmail.com"
                                                                                                              },
                                                                                                              "committer": {
                                                                                                                "date": "2014-11-07T22:01:45Z",
                                                                                                                "name": "Scott Chacon",
                                                                                                                "email": "schacon@gmail.com"
                                                                                                              },
                                                                                                              "message": "my commit message",
                                                                                                              "tree": {
                                                                                                                "url": "https://api.github.com/repos/octocat/Hello-World/git/trees/691272480426f78a0138979dd3ce63b77f706feb",
                                                                                                                "sha": "691272480426f78a0138979dd3ce63b77f706feb"
                                                                                                              },
                                                                                                              "parents": [
                                                                                                                {
                                                                                                                  "url": "https://api.github.com/repos/octocat/Hello-World/git/commits/1acc419d4d6a9ce985db7be48c6349a0475975b5",
                                                                                                                  "html_url": "https://github.com/octocat/Hello-World/git/commit/1acc419d4d6a9ce985db7be48c6349a0475975b5",
                                                                                                                  "sha": "1acc419d4d6a9ce985db7be48c6349a0475975b5"
                                                                                                                }
                                                                                                              ],
                                                                                                              "verification": {
                                                                                                                "verified": false,
                                                                                                                "reason": "unsigned",
                                                                                                                "signature": null,
                                                                                                                "payload": null
                                                                                                              }
                                                                                                            }
                                                                                                          }
                                                                                                          

                                                                                                          Update a file

                                                                                                          This method updates a file in a repository

                                                                                                          PUT /repos/:owner/:repo/contents/:path
                                                                                                          

                                                                                                          Parameters

                                                                                                          Name Type Description
                                                                                                          path string Required. The content path.
                                                                                                          message string Required. The commit message.
                                                                                                          content string Required. The updated file content, Base64 encoded.
                                                                                                          sha string Required. The blob SHA of the file being replaced.
                                                                                                          branch string The branch name. Default: the repository’s default branch (usually master)

                                                                                                          Optional Parameters

                                                                                                          You can provide an additional committer parameter, which is an object containing information about the committer. Or, you can provide an author parameter, which is an object containing information about the author.

                                                                                                          The author section is optional and is filled in with the committer information if omitted. If the committer information is omitted, the authenticated user's information is used.

                                                                                                          You must provide values for both name and email, whether you choose to use author or committer. Otherwise, you'll receive a 422 status code.

                                                                                                          Both the author and committer parameters have the same keys:

                                                                                                          Name Type Description
                                                                                                          name string The name of the author (or committer) of the commit
                                                                                                          email string The email of the author (or committer) of the commit

                                                                                                          Example Input

                                                                                                          {
                                                                                                            "message": "my commit message",
                                                                                                            "committer": {
                                                                                                              "name": "Scott Chacon",
                                                                                                              "email": "schacon@gmail.com"
                                                                                                            },
                                                                                                            "content": "bXkgdXBkYXRlZCBmaWxlIGNvbnRlbnRz",
                                                                                                            "sha": "329688480d39049927147c162b9d2deaf885005f"
                                                                                                          }
                                                                                                          

                                                                                                          Response

                                                                                                          Status: 200 OK
                                                                                                          
                                                                                                          {
                                                                                                            "content": {
                                                                                                              "name": "hello.txt",
                                                                                                              "path": "notes/hello.txt",
                                                                                                              "sha": "95b966ae1c166bd92f8ae7d1c313e738c731dfc3",
                                                                                                              "size": 9,
                                                                                                              "url": "https://api.github.com/repos/octocat/Hello-World/contents/notes/hello.txt",
                                                                                                              "html_url": "https://github.com/octocat/Hello-World/blob/master/notes/hello.txt",
                                                                                                              "git_url": "https://api.github.com/repos/octocat/Hello-World/git/blobs/95b966ae1c166bd92f8ae7d1c313e738c731dfc3",
                                                                                                              "download_url": "https://raw.githubusercontent.com/octocat/HelloWorld/master/notes/hello.txt",
                                                                                                              "type": "file",
                                                                                                              "_links": {
                                                                                                                "self": "https://api.github.com/repos/octocat/Hello-World/contents/notes/hello.txt",
                                                                                                                "git": "https://api.github.com/repos/octocat/Hello-World/git/blobs/95b966ae1c166bd92f8ae7d1c313e738c731dfc3",
                                                                                                                "html": "https://github.com/octocat/Hello-World/blob/master/notes/hello.txt"
                                                                                                              }
                                                                                                            },
                                                                                                            "commit": {
                                                                                                              "sha": "7638417db6d59f3c431d3e1f261cc637155684cd",
                                                                                                              "url": "https://api.github.com/repos/octocat/Hello-World/git/commits/7638417db6d59f3c431d3e1f261cc637155684cd",
                                                                                                              "html_url": "https://github.com/octocat/Hello-World/git/commit/7638417db6d59f3c431d3e1f261cc637155684cd",
                                                                                                              "author": {
                                                                                                                "date": "2014-11-07T22:01:45Z",
                                                                                                                "name": "Scott Chacon",
                                                                                                                "email": "schacon@gmail.com"
                                                                                                              },
                                                                                                              "committer": {
                                                                                                                "date": "2014-11-07T22:01:45Z",
                                                                                                                "name": "Scott Chacon",
                                                                                                                "email": "schacon@gmail.com"
                                                                                                              },
                                                                                                              "message": "my commit message",
                                                                                                              "tree": {
                                                                                                                "url": "https://api.github.com/repos/octocat/Hello-World/git/trees/691272480426f78a0138979dd3ce63b77f706feb",
                                                                                                                "sha": "691272480426f78a0138979dd3ce63b77f706feb"
                                                                                                              },
                                                                                                              "parents": [
                                                                                                                {
                                                                                                                  "url": "https://api.github.com/repos/octocat/Hello-World/git/commits/1acc419d4d6a9ce985db7be48c6349a0475975b5",
                                                                                                                  "html_url": "https://github.com/octocat/Hello-World/git/commit/1acc419d4d6a9ce985db7be48c6349a0475975b5",
                                                                                                                  "sha": "1acc419d4d6a9ce985db7be48c6349a0475975b5"
                                                                                                                }
                                                                                                              ],
                                                                                                              "verification": {
                                                                                                                "verified": false,
                                                                                                                "reason": "unsigned",
                                                                                                                "signature": null,
                                                                                                                "payload": null
                                                                                                              }
                                                                                                            }
                                                                                                          }
                                                                                                          

                                                                                                          Delete a file

                                                                                                          This method deletes a file in a repository

                                                                                                          DELETE /repos/:owner/:repo/contents/:path
                                                                                                          

                                                                                                          Parameters

                                                                                                          Name Type Description
                                                                                                          path string Required. The content path.
                                                                                                          message string Required. The commit message.
                                                                                                          sha string Required. The blob SHA of the file being replaced.
                                                                                                          branch string The branch name. Default: the repository’s default branch (usually master)

                                                                                                          Optional Parameters

                                                                                                          You can provide an additional committer parameter, which is an object containing information about the committer. Or, you can provide an author parameter, which is an object containing information about the author.

                                                                                                          The author section is optional and is filled in with the committer information if omitted. If the committer information is omitted, the authenticated user's information is used.

                                                                                                          You must provide values for both name and email, whether you choose to use author or committer. Otherwise, you'll receive a 422 status code.

                                                                                                          Both the author and committer parameters have the same keys:

                                                                                                          Name Type Description
                                                                                                          name string The name of the author (or committer) of the commit
                                                                                                          email string The email of the author (or committer) of the commit

                                                                                                          Example Input

                                                                                                          {
                                                                                                            "message": "my commit message",
                                                                                                            "committer": {
                                                                                                              "name": "Scott Chacon",
                                                                                                              "email": "schacon@gmail.com"
                                                                                                            },
                                                                                                            "sha": "329688480d39049927147c162b9d2deaf885005f"
                                                                                                          }
                                                                                                          

                                                                                                          Response

                                                                                                          Status: 200 OK
                                                                                                          
                                                                                                          {
                                                                                                            "content": null,
                                                                                                            "commit": {
                                                                                                              "sha": "7638417db6d59f3c431d3e1f261cc637155684cd",
                                                                                                              "url": "https://api.github.com/repos/octocat/Hello-World/git/commits/7638417db6d59f3c431d3e1f261cc637155684cd",
                                                                                                              "html_url": "https://github.com/octocat/Hello-World/git/commit/7638417db6d59f3c431d3e1f261cc637155684cd",
                                                                                                              "author": {
                                                                                                                "date": "2014-11-07T22:01:45Z",
                                                                                                                "name": "Scott Chacon",
                                                                                                                "email": "schacon@gmail.com"
                                                                                                              },
                                                                                                              "committer": {
                                                                                                                "date": "2014-11-07T22:01:45Z",
                                                                                                                "name": "Scott Chacon",
                                                                                                                "email": "schacon@gmail.com"
                                                                                                              },
                                                                                                              "message": "my commit message",
                                                                                                              "tree": {
                                                                                                                "url": "https://api.github.com/repos/octocat/Hello-World/git/trees/691272480426f78a0138979dd3ce63b77f706feb",
                                                                                                                "sha": "691272480426f78a0138979dd3ce63b77f706feb"
                                                                                                              },
                                                                                                              "parents": [
                                                                                                                {
                                                                                                                  "url": "https://api.github.com/repos/octocat/Hello-World/git/commits/1acc419d4d6a9ce985db7be48c6349a0475975b5",
                                                                                                                  "html_url": "https://github.com/octocat/Hello-World/git/commit/1acc419d4d6a9ce985db7be48c6349a0475975b5",
                                                                                                                  "sha": "1acc419d4d6a9ce985db7be48c6349a0475975b5"
                                                                                                                }
                                                                                                              ],
                                                                                                              "verification": {
                                                                                                                "verified": false,
                                                                                                                "reason": "unsigned",
                                                                                                                "signature": null,
                                                                                                                "payload": null
                                                                                                              }
                                                                                                            }
                                                                                                          }
                                                                                                          

                                                                                                          Get archive link

                                                                                                          This method will return a 302 to a URL to download a tarball or zipball archive for a repository. Please make sure your HTTP framework is configured to follow redirects or you will need to use the Location header to make a second GET request.

                                                                                                          Note: For private repositories, these links are temporary and expire after five minutes.

                                                                                                          GET /repos/:owner/:repo/:archive_format/:ref
                                                                                                          

                                                                                                          Parameters

                                                                                                          Name Type Description
                                                                                                          archive_format string Can be either tarball or zipball. Default: tarball
                                                                                                          ref string A valid Git reference. Default: the repository’s default branch (usually master)

                                                                                                          Response

                                                                                                          Status: 302 Found
                                                                                                          Location: https://codeload.github.com/me/myprivate/legacy.zip/master?login=me&token=thistokenexpires
                                                                                                          

                                                                                                          To follow redirects with curl, use the -L switch:

                                                                                                          $curl -L https://api.github.com/repos/octokit/octokit.rb/tarball > octokit.tar.gz
                                                                                                          
                                                                                                            % Total    % Received % Xferd  Average Speed   Time    Time     Time  Current
                                                                                                                                               Dload  Upload   Total   Spent    Left  Speed
                                                                                                          100  206k  100  206k    0     0   146k      0  0:00:01  0:00:01 --:--:--  790k
                                                                                                          

                                                                                                          Custom media types

                                                                                                          READMEs, files, and symlinks support the following custom media types:

                                                                                                          application/vnd.github.VERSION.raw
                                                                                                          application/vnd.github.VERSION.html
                                                                                                          

                                                                                                          Use the .raw media type to retrieve the contents of the file.

                                                                                                          For markup files such as Markdown or AsciiDoc, you can retrieve the rendered HTML using the .html media type. Markup languages are rendered to HTML using our open-source Markup library.

                                                                                                          All objects support the following custom media type:

                                                                                                          application/vnd.github.VERSION.object
                                                                                                          

                                                                                                          Use the object media type parameter to retrieve the contents in a consistent object format regardless of the content type. For example, instead of an array of objects for a directory, the response will be an object with an entries attribute containing the array of objects.

                                                                                                          You can read more about the use of media types in the API here.

                                                                                                          tmp/developer.github.com/v3/repos/deployments/index.html Deployments | GitHub Developer Guide

                                                                                                          Deployments

                                                                                                          Deployments are a request for a specific ref (branch, SHA, tag) to be deployed. GitHub then dispatches deployment events that external services can listen for and act on. This enables developers and organizations to build loosely-coupled tooling around deployments, without having to worry about implementation details of delivering different types of applications (e.g., web, native).

                                                                                                          Deployment statuses allow external services to mark deployments with an error, failure, pending, or success state, which can then be consumed by any system listening for deployment_status events.

                                                                                                          Deployment statuses can also include an optional description and target_url, and we highly recommend providing them as they make deployment statuses much more useful. The target_url would be the full URL to the deployment output, and the description would be the high level summary of what happened with the deployment.

                                                                                                          Deployments and deployment statuses both have associated repository events when they're created. This allows webhooks and 3rd party integrations to respond to deployment requests as well as update the status of a deployment as progress is made.

                                                                                                          Below is a simple sequence diagram for how these interactions would work.

                                                                                                          +---------+             +--------+            +-----------+        +-------------+
                                                                                                          | Tooling |             | GitHub |            | 3rd Party |        | Your Server |
                                                                                                          +---------+             +--------+            +-----------+        +-------------+
                                                                                                               |                      |                       |                     |
                                                                                                               |  Create Deployment   |                       |                     |
                                                                                                               |--------------------->|                       |                     |
                                                                                                               |                      |                       |                     |
                                                                                                               |  Deployment Created  |                       |                     |
                                                                                                               |<---------------------|                       |                     |
                                                                                                               |                      |                       |                     |
                                                                                                               |                      |   Deployment Event    |                     |
                                                                                                               |                      |---------------------->|                     |
                                                                                                               |                      |                       |     SSH+Deploys     |
                                                                                                               |                      |                       |-------------------->|
                                                                                                               |                      |                       |                     |
                                                                                                               |                      |   Deployment Status   |                     |
                                                                                                               |                      |<----------------------|                     |
                                                                                                               |                      |                       |                     |
                                                                                                               |                      |                       |   Deploy Completed  |
                                                                                                               |                      |                       |<--------------------|
                                                                                                               |                      |                       |                     |
                                                                                                               |                      |   Deployment Status   |                     |
                                                                                                               |                      |<----------------------|                     |
                                                                                                               |                      |                       |                     |
                                                                                                          

                                                                                                          Keep in mind that GitHub is never actually accessing your servers. It's up to your 3rd party integration to interact with deployment events. This allows for GitHub integrations as well as running your own systems depending on your use case. Multiple systems can listen for deployment events, and it's up to each of those systems to decide whether or not they're responsible for pushing the code out to your servers, building native code, etc.

                                                                                                          Note that the repo_deployment OAuth scope grants targeted access to deployments and deployment statuses without granting access to repository code, while the repo scope grants permission to code as well.

                                                                                                          Note: To help with migrating from our REST API v3 to GraphQL API v4, we're introducing a preview period to include the GraphQL node_id in the response for many REST API v3 resources. See the blog post for full details. To access node_id during the preview period, you must provide a custom media type in the Accept header:

                                                                                                          application/vnd.github.jean-grey-preview+json
                                                                                                          

                                                                                                          Warning: The API may change without advance notice during the preview period. Preview features are not supported for production use. If you experience any issues, contact GitHub support.

                                                                                                          List deployments

                                                                                                          Simple filtering of deployments is available via query parameters:

                                                                                                          GET /repos/:owner/:repo/deployments
                                                                                                          
                                                                                                          Name Type Description
                                                                                                          sha string The SHA that was recorded at creation time. Default: none
                                                                                                          ref string The name of the ref. This can be a branch, tag, or SHA. Default: none
                                                                                                          task string The name of the task for the deployment (e.g., deploy or deploy:migrations). Default: none
                                                                                                          environment string The name of the environment that was deployed to (e.g., staging or production). Default: none

                                                                                                          Response

                                                                                                          Status: 200 OK
                                                                                                          Link: <https://api.github.com/resource?page=2>; rel="next",
                                                                                                                <https://api.github.com/resource?page=5>; rel="last"
                                                                                                          
                                                                                                          [
                                                                                                            {
                                                                                                              "url": "https://api.github.com/repos/octocat/example/deployments/1",
                                                                                                              "id": 1,
                                                                                                              "sha": "a84d88e7554fc1fa21bcbc4efae3c782a70d2b9d",
                                                                                                              "ref": "master",
                                                                                                              "task": "deploy",
                                                                                                              "payload": {
                                                                                                                "task": "deploy:migrate"
                                                                                                              },
                                                                                                              "environment": "production",
                                                                                                              "description": "Deploy request from hubot",
                                                                                                              "creator": {
                                                                                                                "login": "octocat",
                                                                                                                "id": 1,
                                                                                                                "avatar_url": "https://github.com/images/error/octocat_happy.gif",
                                                                                                                "gravatar_id": "",
                                                                                                                "url": "https://api.github.com/users/octocat",
                                                                                                                "html_url": "https://github.com/octocat",
                                                                                                                "followers_url": "https://api.github.com/users/octocat/followers",
                                                                                                                "following_url": "https://api.github.com/users/octocat/following{/other_user}",
                                                                                                                "gists_url": "https://api.github.com/users/octocat/gists{/gist_id}",
                                                                                                                "starred_url": "https://api.github.com/users/octocat/starred{/owner}{/repo}",
                                                                                                                "subscriptions_url": "https://api.github.com/users/octocat/subscriptions",
                                                                                                                "organizations_url": "https://api.github.com/users/octocat/orgs",
                                                                                                                "repos_url": "https://api.github.com/users/octocat/repos",
                                                                                                                "events_url": "https://api.github.com/users/octocat/events{/privacy}",
                                                                                                                "received_events_url": "https://api.github.com/users/octocat/received_events",
                                                                                                                "type": "User",
                                                                                                                "site_admin": false
                                                                                                              },
                                                                                                              "created_at": "2012-07-20T01:19:13Z",
                                                                                                              "updated_at": "2012-07-20T01:19:13Z",
                                                                                                              "statuses_url": "https://api.github.com/repos/octocat/example/deployments/1/statuses",
                                                                                                              "repository_url": "https://api.github.com/repos/octocat/example"
                                                                                                            }
                                                                                                          ]
                                                                                                          

                                                                                                          Get a single deployment

                                                                                                          GET /repos/:owner/:repo/deployments/:id
                                                                                                          

                                                                                                          Response

                                                                                                          Status: 200 OK
                                                                                                          
                                                                                                          {
                                                                                                            "url": "https://api.github.com/repos/octocat/example/deployments/1",
                                                                                                            "id": 1,
                                                                                                            "sha": "a84d88e7554fc1fa21bcbc4efae3c782a70d2b9d",
                                                                                                            "ref": "master",
                                                                                                            "task": "deploy",
                                                                                                            "payload": {
                                                                                                              "task": "deploy:migrate"
                                                                                                            },
                                                                                                            "environment": "production",
                                                                                                            "description": "Deploy request from hubot",
                                                                                                            "creator": {
                                                                                                              "login": "octocat",
                                                                                                              "id": 1,
                                                                                                              "avatar_url": "https://github.com/images/error/octocat_happy.gif",
                                                                                                              "gravatar_id": "",
                                                                                                              "url": "https://api.github.com/users/octocat",
                                                                                                              "html_url": "https://github.com/octocat",
                                                                                                              "followers_url": "https://api.github.com/users/octocat/followers",
                                                                                                              "following_url": "https://api.github.com/users/octocat/following{/other_user}",
                                                                                                              "gists_url": "https://api.github.com/users/octocat/gists{/gist_id}",
                                                                                                              "starred_url": "https://api.github.com/users/octocat/starred{/owner}{/repo}",
                                                                                                              "subscriptions_url": "https://api.github.com/users/octocat/subscriptions",
                                                                                                              "organizations_url": "https://api.github.com/users/octocat/orgs",
                                                                                                              "repos_url": "https://api.github.com/users/octocat/repos",
                                                                                                              "events_url": "https://api.github.com/users/octocat/events{/privacy}",
                                                                                                              "received_events_url": "https://api.github.com/users/octocat/received_events",
                                                                                                              "type": "User",
                                                                                                              "site_admin": false
                                                                                                            },
                                                                                                            "created_at": "2012-07-20T01:19:13Z",
                                                                                                            "updated_at": "2012-07-20T01:19:13Z",
                                                                                                            "statuses_url": "https://api.github.com/repos/octocat/example/deployments/1/statuses",
                                                                                                            "repository_url": "https://api.github.com/repos/octocat/example"
                                                                                                          }
                                                                                                          

                                                                                                          Deployments created by users via integrations

                                                                                                          Note: An additional performed_via_github_app object in the issue payload is currently available for developers to preview. For more information, see the related blog post.

                                                                                                          To access the API, you must provide a custom media type in the Accept header:

                                                                                                          application/vnd.github.machine-man-preview
                                                                                                          

                                                                                                          Note: If a user created a deployment via a GitHub App, the performed_via_github_app key will contain information on that GitHub App.

                                                                                                          Warning: The API may change without advance notice during the preview period. Preview features are not supported for production use. If you experience any issues, contact GitHub support.

                                                                                                          Create a deployment

                                                                                                          Deployments offer a few configurable parameters with sane defaults.

                                                                                                          The ref parameter can be any named branch, tag, or SHA. At GitHub we often deploy branches and verify them before we merge a pull request.

                                                                                                          The environment parameter allows deployments to be issued to different runtime environments. Teams often have multiple environments for verifying their applications, such as production, staging, and qa. This allows for easy tracking of which environments had deployments requested. The default environment is production.

                                                                                                          The auto_merge parameter is used to ensure that the requested ref is not behind the repository's default branch. If the ref is behind the default branch for the repository, we will attempt to merge it for you. If the merge succeeds, the API will return a successful merge commit. If merge conflicts prevent the merge from succeeding, the API will return a failure response.

                                                                                                          By default, commit statuses for every submitted context must be in a success state. The required_contexts parameter allows you to specify a subset of contexts that must be success, or to specify contexts that have not yet been submitted. You are not required to use commit statuses to deploy. If you do not require any contexts or create any commit statuses, the deployment will always succeed.

                                                                                                          The payload parameter is available for any extra information that a deployment system might need. It is a JSON text field that will be passed on when a deployment event is dispatched.

                                                                                                          The task parameter is used by the deployment system to allow different execution paths. In the web world this might be deploy:migrations to run schema changes on the system. In the compiled world this could be a flag to compile an application with debugging enabled.

                                                                                                          Users with repo or repo_deployment scopes can create a deployment for a given ref:

                                                                                                          POST /repos/:owner/:repo/deployments
                                                                                                          

                                                                                                          Parameters

                                                                                                          Name Type Description
                                                                                                          ref string Required. The ref to deploy. This can be a branch, tag, or SHA.
                                                                                                          task string Specifies a task to execute (e.g., deploy or deploy:migrations). Default: deploy
                                                                                                          auto_merge boolean Attempts to automatically merge the default branch into the requested ref, if it is behind the default branch. Default: true
                                                                                                          required_contexts Array The status contexts to verify against commit status checks. If this parameter is omitted, then all unique contexts will be verified before a deployment is created. To bypass checking entirely pass an empty array. Defaults to all unique contexts.
                                                                                                          payload string JSON payload with extra information about the deployment. Default: ""
                                                                                                          environment string Name for the target deployment environment (e.g., production, staging, qa). Default: production
                                                                                                          description string Short description of the deployment. Default: ""
                                                                                                          transient_environment boolean Specifies if the given environment is specific to the deployment and will no longer exist at some point in the future. Default: false This parameter requires a custom media type to be specified. Please see more in the alert below.
                                                                                                          production_environment boolean Specifies if the given environment is one that end-users directly interact with. Default: true when environment is production and false otherwise. This parameter requires a custom media type to be specified. Please see more in the alert below.

                                                                                                          The new transient_environment and production_environment parameters are currently available for developers to preview. During the preview period, the API may change without advance notice. Please see the blog post for full details.

                                                                                                          To access the API during the preview period, you must provide a custom media type in the Accept header:

                                                                                                          application/vnd.github.ant-man-preview+json
                                                                                                          

                                                                                                          Simple example

                                                                                                          A simple example putting the user and room into the payload to notify back to chat networks.

                                                                                                          {
                                                                                                            "ref": "topic-branch",
                                                                                                            "payload": "{\"user\":\"atmos\",\"room_id\":123456}",
                                                                                                            "description": "Deploying my sweet branch"
                                                                                                          }
                                                                                                          

                                                                                                          Successful response

                                                                                                          Status: 201 Created
                                                                                                          Location: https://api.github.com/repos/octocat/example/deployments/1
                                                                                                          
                                                                                                          {
                                                                                                            "url": "https://api.github.com/repos/octocat/example/deployments/1",
                                                                                                            "id": 1,
                                                                                                            "sha": "a84d88e7554fc1fa21bcbc4efae3c782a70d2b9d",
                                                                                                            "ref": "master",
                                                                                                            "task": "deploy",
                                                                                                            "payload": {
                                                                                                              "task": "deploy:migrate"
                                                                                                            },
                                                                                                            "environment": "production",
                                                                                                            "description": "Deploy request from hubot",
                                                                                                            "creator": {
                                                                                                              "login": "octocat",
                                                                                                              "id": 1,
                                                                                                              "avatar_url": "https://github.com/images/error/octocat_happy.gif",
                                                                                                              "gravatar_id": "",
                                                                                                              "url": "https://api.github.com/users/octocat",
                                                                                                              "html_url": "https://github.com/octocat",
                                                                                                              "followers_url": "https://api.github.com/users/octocat/followers",
                                                                                                              "following_url": "https://api.github.com/users/octocat/following{/other_user}",
                                                                                                              "gists_url": "https://api.github.com/users/octocat/gists{/gist_id}",
                                                                                                              "starred_url": "https://api.github.com/users/octocat/starred{/owner}{/repo}",
                                                                                                              "subscriptions_url": "https://api.github.com/users/octocat/subscriptions",
                                                                                                              "organizations_url": "https://api.github.com/users/octocat/orgs",
                                                                                                              "repos_url": "https://api.github.com/users/octocat/repos",
                                                                                                              "events_url": "https://api.github.com/users/octocat/events{/privacy}",
                                                                                                              "received_events_url": "https://api.github.com/users/octocat/received_events",
                                                                                                              "type": "User",
                                                                                                              "site_admin": false
                                                                                                            },
                                                                                                            "created_at": "2012-07-20T01:19:13Z",
                                                                                                            "updated_at": "2012-07-20T01:19:13Z",
                                                                                                            "statuses_url": "https://api.github.com/repos/octocat/example/deployments/1/statuses",
                                                                                                            "repository_url": "https://api.github.com/repos/octocat/example"
                                                                                                          }
                                                                                                          

                                                                                                          Advanced example

                                                                                                          A more advanced example specifying required commit statuses and bypassing auto-merging.

                                                                                                          {
                                                                                                            "ref": "topic-branch",
                                                                                                            "auto_merge": false,
                                                                                                            "payload": "{\"user\":\"atmos\",\"room_id\":123456}",
                                                                                                            "description": "Deploying my sweet branch",
                                                                                                            "required_contexts": [
                                                                                                              "ci/janky",
                                                                                                              "security/brakeman"
                                                                                                            ]
                                                                                                          }
                                                                                                          

                                                                                                          Successful response

                                                                                                          Status: 201 Created
                                                                                                          Location: https://api.github.com/repos/octocat/example/deployments/1
                                                                                                          
                                                                                                          {
                                                                                                            "url": "https://api.github.com/repos/octocat/example/deployments/1",
                                                                                                            "id": 1,
                                                                                                            "sha": "a84d88e7554fc1fa21bcbc4efae3c782a70d2b9d",
                                                                                                            "ref": "master",
                                                                                                            "task": "deploy",
                                                                                                            "payload": {
                                                                                                              "task": "deploy:migrate"
                                                                                                            },
                                                                                                            "environment": "production",
                                                                                                            "description": "Deploy request from hubot",
                                                                                                            "creator": {
                                                                                                              "login": "octocat",
                                                                                                              "id": 1,
                                                                                                              "avatar_url": "https://github.com/images/error/octocat_happy.gif",
                                                                                                              "gravatar_id": "",
                                                                                                              "url": "https://api.github.com/users/octocat",
                                                                                                              "html_url": "https://github.com/octocat",
                                                                                                              "followers_url": "https://api.github.com/users/octocat/followers",
                                                                                                              "following_url": "https://api.github.com/users/octocat/following{/other_user}",
                                                                                                              "gists_url": "https://api.github.com/users/octocat/gists{/gist_id}",
                                                                                                              "starred_url": "https://api.github.com/users/octocat/starred{/owner}{/repo}",
                                                                                                              "subscriptions_url": "https://api.github.com/users/octocat/subscriptions",
                                                                                                              "organizations_url": "https://api.github.com/users/octocat/orgs",
                                                                                                              "repos_url": "https://api.github.com/users/octocat/repos",
                                                                                                              "events_url": "https://api.github.com/users/octocat/events{/privacy}",
                                                                                                              "received_events_url": "https://api.github.com/users/octocat/received_events",
                                                                                                              "type": "User",
                                                                                                              "site_admin": false
                                                                                                            },
                                                                                                            "created_at": "2012-07-20T01:19:13Z",
                                                                                                            "updated_at": "2012-07-20T01:19:13Z",
                                                                                                            "statuses_url": "https://api.github.com/repos/octocat/example/deployments/1/statuses",
                                                                                                            "repository_url": "https://api.github.com/repos/octocat/example"
                                                                                                          }
                                                                                                          

                                                                                                          Merge conflict response

                                                                                                          This error happens when the auto_merge option is enabled and when the default branch (in this case master), can't be merged into the branch that's being deployed (in this case topic-branch), due to merge conflicts.

                                                                                                          Status: 409 Conflict
                                                                                                          
                                                                                                          {
                                                                                                            "message": "Conflict merging master into topic-branch"
                                                                                                          }
                                                                                                          

                                                                                                          Failed commit status checks

                                                                                                          This error happens when the required_contexts parameter indicates that one or more contexts need to have a success status for the commit to be deployed, but one or more of the required contexts do not have a state of success.

                                                                                                          Status: 409 Conflict
                                                                                                          
                                                                                                          {
                                                                                                            "message": "Conflict: Commit status checks failed for topic-branch."
                                                                                                          }
                                                                                                          

                                                                                                          Update a deployment

                                                                                                          Once a deployment is created, it cannot be updated. Information relating to the success or failure of a deployment is handled through deployment statuses.

                                                                                                          List deployment statuses

                                                                                                          Users with pull access can view deployment statuses for a deployment:

                                                                                                          GET /repos/:owner/:repo/deployments/:id/statuses
                                                                                                          

                                                                                                          Parameters

                                                                                                          Name Type Description
                                                                                                          id integer Required. The deployment ID to list the statuses from.

                                                                                                          Response

                                                                                                          Status: 200 OK
                                                                                                          Link: <https://api.github.com/resource?page=2>; rel="next",
                                                                                                                <https://api.github.com/resource?page=5>; rel="last"
                                                                                                          
                                                                                                          [
                                                                                                            {
                                                                                                              "url": "https://api.github.com/repos/octocat/example/deployments/42/statuses/1",
                                                                                                              "id": 1,
                                                                                                              "state": "success",
                                                                                                              "creator": {
                                                                                                                "login": "octocat",
                                                                                                                "id": 1,
                                                                                                                "avatar_url": "https://github.com/images/error/octocat_happy.gif",
                                                                                                                "gravatar_id": "",
                                                                                                                "url": "https://api.github.com/users/octocat",
                                                                                                                "html_url": "https://github.com/octocat",
                                                                                                                "followers_url": "https://api.github.com/users/octocat/followers",
                                                                                                                "following_url": "https://api.github.com/users/octocat/following{/other_user}",
                                                                                                                "gists_url": "https://api.github.com/users/octocat/gists{/gist_id}",
                                                                                                                "starred_url": "https://api.github.com/users/octocat/starred{/owner}{/repo}",
                                                                                                                "subscriptions_url": "https://api.github.com/users/octocat/subscriptions",
                                                                                                                "organizations_url": "https://api.github.com/users/octocat/orgs",
                                                                                                                "repos_url": "https://api.github.com/users/octocat/repos",
                                                                                                                "events_url": "https://api.github.com/users/octocat/events{/privacy}",
                                                                                                                "received_events_url": "https://api.github.com/users/octocat/received_events",
                                                                                                                "type": "User",
                                                                                                                "site_admin": false
                                                                                                              },
                                                                                                              "description": "Deployment finished successfully.",
                                                                                                              "target_url": "https://example.com/deployment/42/output",
                                                                                                              "created_at": "2012-07-20T01:19:13Z",
                                                                                                              "updated_at": "2012-07-20T01:19:13Z",
                                                                                                              "deployment_url": "https://api.github.com/repos/octocat/example/deployments/42",
                                                                                                              "repository_url": "https://api.github.com/repos/octocat/example"
                                                                                                            }
                                                                                                          ]
                                                                                                          

                                                                                                          Get a single deployment status

                                                                                                          This endpoint is part of the deployment and deployment status enhancement. During the preview period, the API may change without advance notice. Please see the blog post for full details.

                                                                                                          To access the API during the Early Access period, you must provide a custom media type in the Accept header:

                                                                                                            application/vnd.github.ant-man-preview+json
                                                                                                          

                                                                                                          Users with pull access can view a deployment status for a deployment:

                                                                                                          GET /repos/:owner/:repo/deployments/:id/statuses/:status_id
                                                                                                          

                                                                                                          Parameters

                                                                                                          Name Type Description
                                                                                                          id integer Required. The deployment ID to list the statuses from.
                                                                                                          status_id integer Required. The deployment status ID.

                                                                                                          Response

                                                                                                          Status: 200 OK
                                                                                                          
                                                                                                          {
                                                                                                            "url": "https://api.github.com/repos/octocat/example/deployments/42/statuses/1",
                                                                                                            "id": 1,
                                                                                                            "state": "success",
                                                                                                            "creator": {
                                                                                                              "login": "octocat",
                                                                                                              "id": 1,
                                                                                                              "avatar_url": "https://github.com/images/error/octocat_happy.gif",
                                                                                                              "gravatar_id": "",
                                                                                                              "url": "https://api.github.com/users/octocat",
                                                                                                              "html_url": "https://github.com/octocat",
                                                                                                              "followers_url": "https://api.github.com/users/octocat/followers",
                                                                                                              "following_url": "https://api.github.com/users/octocat/following{/other_user}",
                                                                                                              "gists_url": "https://api.github.com/users/octocat/gists{/gist_id}",
                                                                                                              "starred_url": "https://api.github.com/users/octocat/starred{/owner}{/repo}",
                                                                                                              "subscriptions_url": "https://api.github.com/users/octocat/subscriptions",
                                                                                                              "organizations_url": "https://api.github.com/users/octocat/orgs",
                                                                                                              "repos_url": "https://api.github.com/users/octocat/repos",
                                                                                                              "events_url": "https://api.github.com/users/octocat/events{/privacy}",
                                                                                                              "received_events_url": "https://api.github.com/users/octocat/received_events",
                                                                                                              "type": "User",
                                                                                                              "site_admin": false
                                                                                                            },
                                                                                                            "description": "Deployment finished successfully.",
                                                                                                            "target_url": "https://example.com/deployment/42/output",
                                                                                                            "created_at": "2012-07-20T01:19:13Z",
                                                                                                            "updated_at": "2012-07-20T01:19:13Z",
                                                                                                            "deployment_url": "https://api.github.com/repos/octocat/example/deployments/42",
                                                                                                            "repository_url": "https://api.github.com/repos/octocat/example"
                                                                                                          }
                                                                                                          

                                                                                                          Deployment statuses created by users via integrations

                                                                                                          Note: An additional performed_via_github_app object in the issue payload is currently available for developers to preview. For more information, see the related blog post.

                                                                                                          To access the API, you must provide a custom media type in the Accept header:

                                                                                                          application/vnd.github.machine-man-preview
                                                                                                          

                                                                                                          Note: If a user created a deployment status via a GitHub App, the performed_via_github_app key will contain information on that GitHub App.

                                                                                                          Warning: The API may change without advance notice during the preview period. Preview features are not supported for production use. If you experience any issues, contact GitHub support.

                                                                                                          Create a deployment status

                                                                                                          Users with push access can create deployment statuses for a given deployment:

                                                                                                          POST /repos/:owner/:repo/deployments/:id/statuses
                                                                                                          

                                                                                                          Parameters

                                                                                                          Name Type Description
                                                                                                          state string Required. The state of the status. Can be one of error, failure, inactive, pending, or success. The inactive state requires a custom media type to be specified. Please see more in the alert below.
                                                                                                          target_url string The target URL to associate with this status. This URL should contain output to keep the user updated while the task is running or serve as historical information for what happened in the deployment. Default: ""
                                                                                                          log_url string This is functionally equivalent to target_url. We will continue accept target_url to support legacy uses, but we recommend modifying this to the new name to avoid confusion. Default: "" This parameter requires a custom media type to be specified. Please see more in the alert below.
                                                                                                          description string A short description of the status. Maximum length of 140 characters. Default: ""
                                                                                                          environment_url string Sets the URL for accessing your environment. Default: "" This parameter requires a custom media type to be specified. Please see more in the alert below.
                                                                                                          auto_inactive boolean Adds a new inactive status to all non-transient, non-production environment deployments with the same repository and environment name as the created status's deployment. Default: true This parameter requires a custom media type to be specified. Please see more in the alert below.

                                                                                                          The new inactive state, rename of the target_url parameter to log_url, and new environment_url and auto_inactive parameters are currently available for developers to preview. During the preview period, the API may change without advance notice. Please see the blog post for full details.

                                                                                                          To access the API during the preview period, you must provide a custom media type in the Accept header:

                                                                                                          application/vnd.github.ant-man-preview+json
                                                                                                          

                                                                                                          Example

                                                                                                          {
                                                                                                            "state": "success",
                                                                                                            "target_url": "https://example.com/deployment/42/output",
                                                                                                            "description": "Deployment finished successfully."
                                                                                                          }
                                                                                                          

                                                                                                          Response

                                                                                                          Status: 201 Created
                                                                                                          Location: https://api.github.com/repos/octocat/example/deployments/42/statuses/1
                                                                                                          
                                                                                                          {
                                                                                                            "url": "https://api.github.com/repos/octocat/example/deployments/42/statuses/1",
                                                                                                            "id": 1,
                                                                                                            "state": "success",
                                                                                                            "creator": {
                                                                                                              "login": "octocat",
                                                                                                              "id": 1,
                                                                                                              "avatar_url": "https://github.com/images/error/octocat_happy.gif",
                                                                                                              "gravatar_id": "",
                                                                                                              "url": "https://api.github.com/users/octocat",
                                                                                                              "html_url": "https://github.com/octocat",
                                                                                                              "followers_url": "https://api.github.com/users/octocat/followers",
                                                                                                              "following_url": "https://api.github.com/users/octocat/following{/other_user}",
                                                                                                              "gists_url": "https://api.github.com/users/octocat/gists{/gist_id}",
                                                                                                              "starred_url": "https://api.github.com/users/octocat/starred{/owner}{/repo}",
                                                                                                              "subscriptions_url": "https://api.github.com/users/octocat/subscriptions",
                                                                                                              "organizations_url": "https://api.github.com/users/octocat/orgs",
                                                                                                              "repos_url": "https://api.github.com/users/octocat/repos",
                                                                                                              "events_url": "https://api.github.com/users/octocat/events{/privacy}",
                                                                                                              "received_events_url": "https://api.github.com/users/octocat/received_events",
                                                                                                              "type": "User",
                                                                                                              "site_admin": false
                                                                                                            },
                                                                                                            "description": "Deployment finished successfully.",
                                                                                                            "target_url": "https://example.com/deployment/42/output",
                                                                                                            "created_at": "2012-07-20T01:19:13Z",
                                                                                                            "updated_at": "2012-07-20T01:19:13Z",
                                                                                                            "deployment_url": "https://api.github.com/repos/octocat/example/deployments/42",
                                                                                                            "repository_url": "https://api.github.com/repos/octocat/example"
                                                                                                          }
                                                                                                          
                                                                                                          tmp/developer.github.com/v3/repos/downloads/index.html Downloads | GitHub Developer Guide

                                                                                                          Downloads

                                                                                                          Downloads API is Deprecated

                                                                                                          The Downloads API (described below) was deprecated on December 11, 2012. It will be removed at a future date.

                                                                                                          We recommend using Releases instead.

                                                                                                          The downloads API is for package downloads only. If you want to get source tarballs you should use this instead.

                                                                                                          List downloads for a repository

                                                                                                          GET /repos/:owner/:repo/downloads
                                                                                                          

                                                                                                          Response

                                                                                                          Status: 200 OK
                                                                                                          Link: <https://api.github.com/resource?page=2>; rel="next",
                                                                                                                <https://api.github.com/resource?page=5>; rel="last"
                                                                                                          
                                                                                                          [
                                                                                                            {
                                                                                                              "url": "https://api.github.com/repos/octocat/Hello-World/downloads/1",
                                                                                                              "html_url": "https://github.com/repos/octocat/Hello-World/downloads/new_file.jpg",
                                                                                                              "id": 1,
                                                                                                              "name": "new_file.jpg",
                                                                                                              "description": "Description of your download",
                                                                                                              "size": 1024,
                                                                                                              "download_count": 40,
                                                                                                              "content_type": ".jpg"
                                                                                                            }
                                                                                                          ]
                                                                                                          

                                                                                                          Get a single download

                                                                                                          GET /repos/:owner/:repo/downloads/:id
                                                                                                          

                                                                                                          Response

                                                                                                          Status: 200 OK
                                                                                                          
                                                                                                          {
                                                                                                            "url": "https://api.github.com/repos/octocat/Hello-World/downloads/1",
                                                                                                            "html_url": "https://github.com/repos/octocat/Hello-World/downloads/new_file.jpg",
                                                                                                            "id": 1,
                                                                                                            "name": "new_file.jpg",
                                                                                                            "description": "Description of your download",
                                                                                                            "size": 1024,
                                                                                                            "download_count": 40,
                                                                                                            "content_type": ".jpg"
                                                                                                          }
                                                                                                          

                                                                                                          Delete a download

                                                                                                          DELETE /repos/:owner/:repo/downloads/:id
                                                                                                          

                                                                                                          Response

                                                                                                          Status: 204 No Content
                                                                                                          
                                                                                                          tmp/developer.github.com/v3/repos/forks/index.html Forks | GitHub Developer Guide

                                                                                                          Forks

                                                                                                          List forks

                                                                                                          GET /repos/:owner/:repo/forks
                                                                                                          

                                                                                                          Parameters

                                                                                                          Name Type Description
                                                                                                          sort string The sort order. Can be either newest, oldest, or stargazers. Default: newest

                                                                                                          Response

                                                                                                          Status: 200 OK
                                                                                                          Link: <https://api.github.com/resource?page=2>; rel="next",
                                                                                                                <https://api.github.com/resource?page=5>; rel="last"
                                                                                                          
                                                                                                          [
                                                                                                            {
                                                                                                              "id": 1296269,
                                                                                                              "owner": {
                                                                                                                "login": "octocat",
                                                                                                                "id": 1,
                                                                                                                "avatar_url": "https://github.com/images/error/octocat_happy.gif",
                                                                                                                "gravatar_id": "",
                                                                                                                "url": "https://api.github.com/users/octocat",
                                                                                                                "html_url": "https://github.com/octocat",
                                                                                                                "followers_url": "https://api.github.com/users/octocat/followers",
                                                                                                                "following_url": "https://api.github.com/users/octocat/following{/other_user}",
                                                                                                                "gists_url": "https://api.github.com/users/octocat/gists{/gist_id}",
                                                                                                                "starred_url": "https://api.github.com/users/octocat/starred{/owner}{/repo}",
                                                                                                                "subscriptions_url": "https://api.github.com/users/octocat/subscriptions",
                                                                                                                "organizations_url": "https://api.github.com/users/octocat/orgs",
                                                                                                                "repos_url": "https://api.github.com/users/octocat/repos",
                                                                                                                "events_url": "https://api.github.com/users/octocat/events{/privacy}",
                                                                                                                "received_events_url": "https://api.github.com/users/octocat/received_events",
                                                                                                                "type": "User",
                                                                                                                "site_admin": false
                                                                                                              },
                                                                                                              "name": "Hello-World",
                                                                                                              "full_name": "octocat/Hello-World",
                                                                                                              "description": "This your first repo!",
                                                                                                              "private": false,
                                                                                                              "fork": true,
                                                                                                              "url": "https://api.github.com/repos/octocat/Hello-World",
                                                                                                              "html_url": "https://github.com/octocat/Hello-World",
                                                                                                              "archive_url": "http://api.github.com/repos/octocat/Hello-World/{archive_format}{/ref}",
                                                                                                              "assignees_url": "http://api.github.com/repos/octocat/Hello-World/assignees{/user}",
                                                                                                              "blobs_url": "http://api.github.com/repos/octocat/Hello-World/git/blobs{/sha}",
                                                                                                              "branches_url": "http://api.github.com/repos/octocat/Hello-World/branches{/branch}",
                                                                                                              "clone_url": "https://github.com/octocat/Hello-World.git",
                                                                                                              "collaborators_url": "http://api.github.com/repos/octocat/Hello-World/collaborators{/collaborator}",
                                                                                                              "comments_url": "http://api.github.com/repos/octocat/Hello-World/comments{/number}",
                                                                                                              "commits_url": "http://api.github.com/repos/octocat/Hello-World/commits{/sha}",
                                                                                                              "compare_url": "http://api.github.com/repos/octocat/Hello-World/compare/{base}...{head}",
                                                                                                              "contents_url": "http://api.github.com/repos/octocat/Hello-World/contents/{+path}",
                                                                                                              "contributors_url": "http://api.github.com/repos/octocat/Hello-World/contributors",
                                                                                                              "deployments_url": "http://api.github.com/repos/octocat/Hello-World/deployments",
                                                                                                              "downloads_url": "http://api.github.com/repos/octocat/Hello-World/downloads",
                                                                                                              "events_url": "http://api.github.com/repos/octocat/Hello-World/events",
                                                                                                              "forks_url": "http://api.github.com/repos/octocat/Hello-World/forks",
                                                                                                              "git_commits_url": "http://api.github.com/repos/octocat/Hello-World/git/commits{/sha}",
                                                                                                              "git_refs_url": "http://api.github.com/repos/octocat/Hello-World/git/refs{/sha}",
                                                                                                              "git_tags_url": "http://api.github.com/repos/octocat/Hello-World/git/tags{/sha}",
                                                                                                              "git_url": "git:github.com/octocat/Hello-World.git",
                                                                                                              "hooks_url": "http://api.github.com/repos/octocat/Hello-World/hooks",
                                                                                                              "issue_comment_url": "http://api.github.com/repos/octocat/Hello-World/issues/comments{/number}",
                                                                                                              "issue_events_url": "http://api.github.com/repos/octocat/Hello-World/issues/events{/number}",
                                                                                                              "issues_url": "http://api.github.com/repos/octocat/Hello-World/issues{/number}",
                                                                                                              "keys_url": "http://api.github.com/repos/octocat/Hello-World/keys{/key_id}",
                                                                                                              "labels_url": "http://api.github.com/repos/octocat/Hello-World/labels{/name}",
                                                                                                              "languages_url": "http://api.github.com/repos/octocat/Hello-World/languages",
                                                                                                              "merges_url": "http://api.github.com/repos/octocat/Hello-World/merges",
                                                                                                              "milestones_url": "http://api.github.com/repos/octocat/Hello-World/milestones{/number}",
                                                                                                              "mirror_url": "git:git.example.com/octocat/Hello-World",
                                                                                                              "notifications_url": "http://api.github.com/repos/octocat/Hello-World/notifications{?since,all,participating}",
                                                                                                              "pulls_url": "http://api.github.com/repos/octocat/Hello-World/pulls{/number}",
                                                                                                              "releases_url": "http://api.github.com/repos/octocat/Hello-World/releases{/id}",
                                                                                                              "ssh_url": "git@github.com:octocat/Hello-World.git",
                                                                                                              "stargazers_url": "http://api.github.com/repos/octocat/Hello-World/stargazers",
                                                                                                              "statuses_url": "http://api.github.com/repos/octocat/Hello-World/statuses/{sha}",
                                                                                                              "subscribers_url": "http://api.github.com/repos/octocat/Hello-World/subscribers",
                                                                                                              "subscription_url": "http://api.github.com/repos/octocat/Hello-World/subscription",
                                                                                                              "svn_url": "https://svn.github.com/octocat/Hello-World",
                                                                                                              "tags_url": "http://api.github.com/repos/octocat/Hello-World/tags",
                                                                                                              "teams_url": "http://api.github.com/repos/octocat/Hello-World/teams",
                                                                                                              "trees_url": "http://api.github.com/repos/octocat/Hello-World/git/trees{/sha}",
                                                                                                              "homepage": "https://github.com",
                                                                                                              "language": null,
                                                                                                              "forks_count": 9,
                                                                                                              "stargazers_count": 80,
                                                                                                              "watchers_count": 80,
                                                                                                              "size": 108,
                                                                                                              "default_branch": "master",
                                                                                                              "open_issues_count": 0,
                                                                                                              "topics": [
                                                                                                                "octocat",
                                                                                                                "atom",
                                                                                                                "electron",
                                                                                                                "API"
                                                                                                              ],
                                                                                                              "has_issues": true,
                                                                                                              "has_wiki": true,
                                                                                                              "has_pages": false,
                                                                                                              "has_downloads": true,
                                                                                                              "archived": false,
                                                                                                              "pushed_at": "2011-01-26T19:06:43Z",
                                                                                                              "created_at": "2011-01-26T19:01:12Z",
                                                                                                              "updated_at": "2011-01-26T19:14:43Z",
                                                                                                              "permissions": {
                                                                                                                "admin": false,
                                                                                                                "push": false,
                                                                                                                "pull": true
                                                                                                              },
                                                                                                              "allow_rebase_merge": true,
                                                                                                              "allow_squash_merge": true,
                                                                                                              "allow_merge_commit": true,
                                                                                                              "subscribers_count": 42,
                                                                                                              "network_count": 0,
                                                                                                              "license": {
                                                                                                                "key": "mit",
                                                                                                                "name": "MIT License",
                                                                                                                "spdx_id": "MIT",
                                                                                                                "url": "https://api.github.com/licenses/mit",
                                                                                                                "html_url": "http://choosealicense.com/licenses/mit/"
                                                                                                              }
                                                                                                            }
                                                                                                          ]
                                                                                                          

                                                                                                          Create a fork

                                                                                                          Create a fork for the authenticated user.

                                                                                                          POST /repos/:owner/:repo/forks
                                                                                                          

                                                                                                          Parameters

                                                                                                          Name Type Description
                                                                                                          organization string Optional parameter to specify the organization name if forking into an organization.

                                                                                                          Response

                                                                                                          Forking a Repository happens asynchronously. Therefore, you may have to wait a short period before accessing the git objects. If this takes longer than 5 minutes, be sure to contact GitHub support.

                                                                                                          Status: 202 Accepted
                                                                                                          
                                                                                                          {
                                                                                                            "id": 1296269,
                                                                                                            "owner": {
                                                                                                              "login": "octocat",
                                                                                                              "id": 1,
                                                                                                              "avatar_url": "https://github.com/images/error/octocat_happy.gif",
                                                                                                              "gravatar_id": "",
                                                                                                              "url": "https://api.github.com/users/octocat",
                                                                                                              "html_url": "https://github.com/octocat",
                                                                                                              "followers_url": "https://api.github.com/users/octocat/followers",
                                                                                                              "following_url": "https://api.github.com/users/octocat/following{/other_user}",
                                                                                                              "gists_url": "https://api.github.com/users/octocat/gists{/gist_id}",
                                                                                                              "starred_url": "https://api.github.com/users/octocat/starred{/owner}{/repo}",
                                                                                                              "subscriptions_url": "https://api.github.com/users/octocat/subscriptions",
                                                                                                              "organizations_url": "https://api.github.com/users/octocat/orgs",
                                                                                                              "repos_url": "https://api.github.com/users/octocat/repos",
                                                                                                              "events_url": "https://api.github.com/users/octocat/events{/privacy}",
                                                                                                              "received_events_url": "https://api.github.com/users/octocat/received_events",
                                                                                                              "type": "User",
                                                                                                              "site_admin": false
                                                                                                            },
                                                                                                            "name": "Hello-World",
                                                                                                            "full_name": "octocat/Hello-World",
                                                                                                            "description": "This your first repo!",
                                                                                                            "private": false,
                                                                                                            "fork": true,
                                                                                                            "url": "https://api.github.com/repos/octocat/Hello-World",
                                                                                                            "html_url": "https://github.com/octocat/Hello-World",
                                                                                                            "archive_url": "http://api.github.com/repos/octocat/Hello-World/{archive_format}{/ref}",
                                                                                                            "assignees_url": "http://api.github.com/repos/octocat/Hello-World/assignees{/user}",
                                                                                                            "blobs_url": "http://api.github.com/repos/octocat/Hello-World/git/blobs{/sha}",
                                                                                                            "branches_url": "http://api.github.com/repos/octocat/Hello-World/branches{/branch}",
                                                                                                            "clone_url": "https://github.com/octocat/Hello-World.git",
                                                                                                            "collaborators_url": "http://api.github.com/repos/octocat/Hello-World/collaborators{/collaborator}",
                                                                                                            "comments_url": "http://api.github.com/repos/octocat/Hello-World/comments{/number}",
                                                                                                            "commits_url": "http://api.github.com/repos/octocat/Hello-World/commits{/sha}",
                                                                                                            "compare_url": "http://api.github.com/repos/octocat/Hello-World/compare/{base}...{head}",
                                                                                                            "contents_url": "http://api.github.com/repos/octocat/Hello-World/contents/{+path}",
                                                                                                            "contributors_url": "http://api.github.com/repos/octocat/Hello-World/contributors",
                                                                                                            "deployments_url": "http://api.github.com/repos/octocat/Hello-World/deployments",
                                                                                                            "downloads_url": "http://api.github.com/repos/octocat/Hello-World/downloads",
                                                                                                            "events_url": "http://api.github.com/repos/octocat/Hello-World/events",
                                                                                                            "forks_url": "http://api.github.com/repos/octocat/Hello-World/forks",
                                                                                                            "git_commits_url": "http://api.github.com/repos/octocat/Hello-World/git/commits{/sha}",
                                                                                                            "git_refs_url": "http://api.github.com/repos/octocat/Hello-World/git/refs{/sha}",
                                                                                                            "git_tags_url": "http://api.github.com/repos/octocat/Hello-World/git/tags{/sha}",
                                                                                                            "git_url": "git:github.com/octocat/Hello-World.git",
                                                                                                            "hooks_url": "http://api.github.com/repos/octocat/Hello-World/hooks",
                                                                                                            "issue_comment_url": "http://api.github.com/repos/octocat/Hello-World/issues/comments{/number}",
                                                                                                            "issue_events_url": "http://api.github.com/repos/octocat/Hello-World/issues/events{/number}",
                                                                                                            "issues_url": "http://api.github.com/repos/octocat/Hello-World/issues{/number}",
                                                                                                            "keys_url": "http://api.github.com/repos/octocat/Hello-World/keys{/key_id}",
                                                                                                            "labels_url": "http://api.github.com/repos/octocat/Hello-World/labels{/name}",
                                                                                                            "languages_url": "http://api.github.com/repos/octocat/Hello-World/languages",
                                                                                                            "merges_url": "http://api.github.com/repos/octocat/Hello-World/merges",
                                                                                                            "milestones_url": "http://api.github.com/repos/octocat/Hello-World/milestones{/number}",
                                                                                                            "mirror_url": "git:git.example.com/octocat/Hello-World",
                                                                                                            "notifications_url": "http://api.github.com/repos/octocat/Hello-World/notifications{?since,all,participating}",
                                                                                                            "pulls_url": "http://api.github.com/repos/octocat/Hello-World/pulls{/number}",
                                                                                                            "releases_url": "http://api.github.com/repos/octocat/Hello-World/releases{/id}",
                                                                                                            "ssh_url": "git@github.com:octocat/Hello-World.git",
                                                                                                            "stargazers_url": "http://api.github.com/repos/octocat/Hello-World/stargazers",
                                                                                                            "statuses_url": "http://api.github.com/repos/octocat/Hello-World/statuses/{sha}",
                                                                                                            "subscribers_url": "http://api.github.com/repos/octocat/Hello-World/subscribers",
                                                                                                            "subscription_url": "http://api.github.com/repos/octocat/Hello-World/subscription",
                                                                                                            "svn_url": "https://svn.github.com/octocat/Hello-World",
                                                                                                            "tags_url": "http://api.github.com/repos/octocat/Hello-World/tags",
                                                                                                            "teams_url": "http://api.github.com/repos/octocat/Hello-World/teams",
                                                                                                            "trees_url": "http://api.github.com/repos/octocat/Hello-World/git/trees{/sha}",
                                                                                                            "homepage": "https://github.com",
                                                                                                            "language": null,
                                                                                                            "forks_count": 9,
                                                                                                            "stargazers_count": 80,
                                                                                                            "watchers_count": 80,
                                                                                                            "size": 108,
                                                                                                            "default_branch": "master",
                                                                                                            "open_issues_count": 0,
                                                                                                            "topics": [
                                                                                                              "octocat",
                                                                                                              "atom",
                                                                                                              "electron",
                                                                                                              "API"
                                                                                                            ],
                                                                                                            "has_issues": true,
                                                                                                            "has_wiki": true,
                                                                                                            "has_pages": false,
                                                                                                            "has_downloads": true,
                                                                                                            "archived": false,
                                                                                                            "pushed_at": "2011-01-26T19:06:43Z",
                                                                                                            "created_at": "2011-01-26T19:01:12Z",
                                                                                                            "updated_at": "2011-01-26T19:14:43Z",
                                                                                                            "permissions": {
                                                                                                              "admin": false,
                                                                                                              "push": false,
                                                                                                              "pull": true
                                                                                                            },
                                                                                                            "allow_rebase_merge": true,
                                                                                                            "allow_squash_merge": true,
                                                                                                            "allow_merge_commit": true,
                                                                                                            "subscribers_count": 42,
                                                                                                            "network_count": 0
                                                                                                          }
                                                                                                          
                                                                                                          tmp/developer.github.com/v3/repos/hooks/index.html Repository Webhooks | GitHub Developer Guide

                                                                                                          Webhooks

                                                                                                          The Repository Webhooks API allows repository admins to manage the post-receive hooks for a repository. Webhooks can be managed using the JSON HTTP API, or the PubSubHubbub API.

                                                                                                          If you would like to set up a single webhook to receive events from all of your organization's repositories, check out our API documentation for Organization Webhooks.

                                                                                                          List hooks

                                                                                                          GET /repos/:owner/:repo/hooks
                                                                                                          

                                                                                                          Response

                                                                                                          Status: 200 OK
                                                                                                          Link: <https://api.github.com/resource?page=2>; rel="next",
                                                                                                                <https://api.github.com/resource?page=5>; rel="last"
                                                                                                          
                                                                                                          [
                                                                                                            {
                                                                                                              "id": 1,
                                                                                                              "url": "https://api.github.com/repos/octocat/Hello-World/hooks/1",
                                                                                                              "test_url": "https://api.github.com/repos/octocat/Hello-World/hooks/1/test",
                                                                                                              "ping_url": "https://api.github.com/repos/octocat/Hello-World/hooks/1/pings",
                                                                                                              "name": "web",
                                                                                                              "events": [
                                                                                                                "push",
                                                                                                                "pull_request"
                                                                                                              ],
                                                                                                              "active": true,
                                                                                                              "config": {
                                                                                                                "url": "http://example.com/webhook",
                                                                                                                "content_type": "json"
                                                                                                              },
                                                                                                              "updated_at": "2011-09-06T20:39:23Z",
                                                                                                              "created_at": "2011-09-06T17:26:27Z"
                                                                                                            }
                                                                                                          ]
                                                                                                          

                                                                                                          Get single hook

                                                                                                          GET /repos/:owner/:repo/hooks/:id
                                                                                                          

                                                                                                          Response

                                                                                                          Status: 200 OK
                                                                                                          
                                                                                                          {
                                                                                                            "id": 1,
                                                                                                            "url": "https://api.github.com/repos/octocat/Hello-World/hooks/1",
                                                                                                            "test_url": "https://api.github.com/repos/octocat/Hello-World/hooks/1/test",
                                                                                                            "ping_url": "https://api.github.com/repos/octocat/Hello-World/hooks/1/pings",
                                                                                                            "name": "web",
                                                                                                            "events": [
                                                                                                              "push",
                                                                                                              "pull_request"
                                                                                                            ],
                                                                                                            "active": true,
                                                                                                            "config": {
                                                                                                              "url": "http://example.com/webhook",
                                                                                                              "content_type": "json"
                                                                                                            },
                                                                                                            "updated_at": "2011-09-06T20:39:23Z",
                                                                                                            "created_at": "2011-09-06T17:26:27Z"
                                                                                                          }
                                                                                                          

                                                                                                          Create a hook

                                                                                                          POST /repos/:owner/:repo/hooks
                                                                                                          

                                                                                                          Note: Repository service hooks (like email or Campfire) can have at most one configured at a time. Creating hooks for a service that already has one configured will update the existing hook.

                                                                                                          Repositories can have multiple webhooks installed. Each webhook should have a unique config. Multiple webhooks can share the same config as long as those webhooks do not have any events that overlap.

                                                                                                          Parameters

                                                                                                          Name Type Description
                                                                                                          name string Required. Must be passed as "web".
                                                                                                          config object Required. Key/value pairs to provide settings for this webhook. These are defined below.
                                                                                                          events array Determines what events the hook is triggered for. Default: ["push"]
                                                                                                          active boolean Determines if notifications are sent when the webhook is triggered. Set to true to send notifications. Default: true.

                                                                                                          The config object can accept the following keys:

                                                                                                          Name Type Description
                                                                                                          url string Required The URL to which the payloads will be delivered.
                                                                                                          content_type string The media type used to serialize the payloads. Supported values include json and form. The default is form.
                                                                                                          secret string If provided, the secret will be used as the key to generate the HMAC hex digest value in the X-Hub-Signature header.
                                                                                                          insecure_ssl string Determines whether the SSL certificate of the host for url will be verified when delivering payloads. Supported values include 0 (verification is performed) and 1 (verification is not performed). The default is 0. We strongly recommend not setting this to 1 as you are subject to man-in-the-middle and other attacks.

                                                                                                          Example

                                                                                                          Here's how you can create a hook that posts payloads in JSON format:

                                                                                                          {
                                                                                                            "name": "web",
                                                                                                            "active": true,
                                                                                                            "events": [
                                                                                                              "push",
                                                                                                              "pull_request"
                                                                                                            ],
                                                                                                            "config": {
                                                                                                              "url": "http://example.com/webhook",
                                                                                                              "content_type": "json"
                                                                                                            }
                                                                                                          }
                                                                                                          

                                                                                                          Response

                                                                                                          Status: 201 Created
                                                                                                          Location: https://api.github.com/repos/octocat/Hello-World/hooks/1
                                                                                                          
                                                                                                          {
                                                                                                            "id": 1,
                                                                                                            "url": "https://api.github.com/repos/octocat/Hello-World/hooks/1",
                                                                                                            "test_url": "https://api.github.com/repos/octocat/Hello-World/hooks/1/test",
                                                                                                            "ping_url": "https://api.github.com/repos/octocat/Hello-World/hooks/1/pings",
                                                                                                            "name": "web",
                                                                                                            "events": [
                                                                                                              "push",
                                                                                                              "pull_request"
                                                                                                            ],
                                                                                                            "active": true,
                                                                                                            "config": {
                                                                                                              "url": "http://example.com/webhook",
                                                                                                              "content_type": "json"
                                                                                                            },
                                                                                                            "updated_at": "2011-09-06T20:39:23Z",
                                                                                                            "created_at": "2011-09-06T17:26:27Z"
                                                                                                          }
                                                                                                          

                                                                                                          Edit a hook

                                                                                                          PATCH /repos/:owner/:repo/hooks/:id
                                                                                                          

                                                                                                          Parameters

                                                                                                          Name Type Description
                                                                                                          config object Required. Key/value pairs to provide settings for this webhook. These are defined below.
                                                                                                          events array Determines what events the hook is triggered for. This replaces the entire array of events. Default: ["push"]
                                                                                                          add_events array Determines a list of events to be added to the list of events that the Hook triggers for.
                                                                                                          remove_events array Determines a list of events to be removed from the list of events that the Hook triggers for.
                                                                                                          active boolean Determines if notifications are sent when the webhook is triggered. Set to true to send notifications. Default: true.

                                                                                                          The config object can accept the following keys:

                                                                                                          Name Type Description
                                                                                                          url string Required The URL to which the payloads will be delivered.
                                                                                                          content_type string The media type used to serialize the payloads. Supported values include json and form. The default is form.
                                                                                                          secret string If provided, the secret will be used as the key to generate the HMAC hex digest value in the X-Hub-Signature header.
                                                                                                          insecure_ssl string Determines whether the SSL certificate of the host for url will be verified when delivering payloads. Supported values include 0 (verification is performed) and 1 (verification is not performed). The default is 0. We strongly recommend not setting this to 1 as you are subject to man-in-the-middle and other attacks.

                                                                                                          Example

                                                                                                          {
                                                                                                            "active": true,
                                                                                                            "add_events": [
                                                                                                              "pull_request"
                                                                                                            ]
                                                                                                          }
                                                                                                          

                                                                                                          Response

                                                                                                          Status: 200 OK
                                                                                                          
                                                                                                          {
                                                                                                            "id": 1,
                                                                                                            "url": "https://api.github.com/repos/octocat/Hello-World/hooks/1",
                                                                                                            "test_url": "https://api.github.com/repos/octocat/Hello-World/hooks/1/test",
                                                                                                            "ping_url": "https://api.github.com/repos/octocat/Hello-World/hooks/1/pings",
                                                                                                            "name": "web",
                                                                                                            "events": [
                                                                                                              "push",
                                                                                                              "pull_request"
                                                                                                            ],
                                                                                                            "active": true,
                                                                                                            "config": {
                                                                                                              "url": "http://example.com/webhook",
                                                                                                              "content_type": "json"
                                                                                                            },
                                                                                                            "updated_at": "2011-09-06T20:39:23Z",
                                                                                                            "created_at": "2011-09-06T17:26:27Z"
                                                                                                          }
                                                                                                          

                                                                                                          Test a push hook

                                                                                                          This will trigger the hook with the latest push to the current repository if the hook is subscribed to push events. If the hook is not subscribed to push events, the server will respond with 204 but no test POST will be generated.

                                                                                                          POST /repos/:owner/:repo/hooks/:id/tests
                                                                                                          

                                                                                                          Note: Previously /repos/:owner/:repo/hooks/:id/test

                                                                                                          Response

                                                                                                          Status: 204 No Content
                                                                                                          

                                                                                                          Ping a hook

                                                                                                          This will trigger a ping event to be sent to the hook.

                                                                                                          POST /repos/:owner/:repo/hooks/:id/pings
                                                                                                          

                                                                                                          Response

                                                                                                          Status: 204 No Content
                                                                                                          

                                                                                                          Delete a hook

                                                                                                          DELETE /repos/:owner/:repo/hooks/:id
                                                                                                          

                                                                                                          Response

                                                                                                          Status: 204 No Content
                                                                                                          

                                                                                                          Receiving Webhooks

                                                                                                          In order for GitHub to send webhook payloads, your server needs to be accessible from the Internet. We also highly suggest using SSL so that we can send encrypted payloads over HTTPS.

                                                                                                          Webhook headers

                                                                                                          GitHub will send along several HTTP headers to differentiate between event types and payload identifiers. See webhook headers for details.

                                                                                                          PubSubHubbub

                                                                                                          GitHub can also serve as a PubSubHubbub hub for all repositories. PSHB is a simple publish/subscribe protocol that lets servers register to receive updates when a topic is updated. The updates are sent with an HTTP POST request to a callback URL. Topic URLs for a GitHub repository's pushes are in this format:

                                                                                                          https://github.com/:owner/:repo/events/:event
                                                                                                          

                                                                                                          The event can be any event string that is listed at the top of this document.

                                                                                                          Response format

                                                                                                          The default format is what existing post-receive hooks should expect: A JSON body sent as the payload parameter in a POST. You can also specify to receive the raw JSON body with either an Accept header, or a .json extension.

                                                                                                          Accept: application/json
                                                                                                          https://github.com/:owner/:repo/events/push.json
                                                                                                          

                                                                                                          Callback URLs

                                                                                                          Callback URLs can use either the http:// protocol, or github://. github:// callbacks specify a GitHub service.

                                                                                                          # Send updates to postbin.org
                                                                                                          http://postbin.org/123
                                                                                                          
                                                                                                          # Send updates to Campfire
                                                                                                          github://campfire?subdomain=github&room=Commits&token=abc123
                                                                                                          

                                                                                                          Subscribing

                                                                                                          The GitHub PubSubHubbub endpoint is: https://api.github.com/hub. (GitHub Enterprise users should use http://yourhost/api/v3/hub as the PubSubHubbub endpoint, but not change the hub.topic URI format.) A successful request with curl looks like:

                                                                                                          curl -u "user" -i \
                                                                                                            https://api.github.com/hub \
                                                                                                            -F "hub.mode=subscribe" \
                                                                                                            -F "hub.topic=https://github.com/:owner/:repo/events/push" \
                                                                                                            -F "hub.callback=http://postbin.org/123"
                                                                                                          

                                                                                                          PubSubHubbub requests can be sent multiple times. If the hook already exists, it will be modified according to the request.

                                                                                                          Parameters

                                                                                                          Name Type Description
                                                                                                          hub.mode string Required. Either subscribe or unsubscribe.
                                                                                                          hub.topic string Required. The URI of the GitHub repository to subscribe to. The path must be in the format of /:owner/:repo/events/:event.
                                                                                                          hub.callback string The URI to receive the updates to the topic.
                                                                                                          hub.secret string A shared secret key that generates a SHA1 HMAC of the outgoing body content. You can verify a push came from GitHub by comparing the raw request body with the contents of the X-Hub-Signature header. You can see the PubSubHubbub documentation for more details.
                                                                                                          tmp/developer.github.com/v3/repos/invitations/index.html Repository Invitations | GitHub Developer Guide

                                                                                                          Repository Invitations

                                                                                                          The Repository Invitations API allows users or external services to invite other users to collaborate on a repo. The invited users (or external services on behalf of invited users) can choose to accept or decline the invitations.

                                                                                                          Note that the repo:invite OAuth scope grants targeted access to invitations without also granting access to repository code, while the repo scope grants permission to code as well as invitations.

                                                                                                          Invite a user to a repository

                                                                                                          Use the API endpoint for adding a collaborator here.

                                                                                                          List invitations for a repository

                                                                                                          GET /repos/:owner/:repo/invitations
                                                                                                          

                                                                                                          When authenticating as a user with admin rights to a repository, this endpoint will list all currently open repository invitations.

                                                                                                          Response

                                                                                                          Status: 200 OK
                                                                                                          Link: <https://api.github.com/resource?page=2>; rel="next",
                                                                                                                <https://api.github.com/resource?page=5>; rel="last"
                                                                                                          
                                                                                                          [
                                                                                                            {
                                                                                                              "id": 1,
                                                                                                              "repository": {
                                                                                                                "id": 1296269,
                                                                                                                "owner": {
                                                                                                                  "login": "octocat",
                                                                                                                  "id": 1,
                                                                                                                  "avatar_url": "https://github.com/images/error/octocat_happy.gif",
                                                                                                                  "gravatar_id": "",
                                                                                                                  "url": "https://api.github.com/users/octocat",
                                                                                                                  "html_url": "https://github.com/octocat",
                                                                                                                  "followers_url": "https://api.github.com/users/octocat/followers",
                                                                                                                  "following_url": "https://api.github.com/users/octocat/following{/other_user}",
                                                                                                                  "gists_url": "https://api.github.com/users/octocat/gists{/gist_id}",
                                                                                                                  "starred_url": "https://api.github.com/users/octocat/starred{/owner}{/repo}",
                                                                                                                  "subscriptions_url": "https://api.github.com/users/octocat/subscriptions",
                                                                                                                  "organizations_url": "https://api.github.com/users/octocat/orgs",
                                                                                                                  "repos_url": "https://api.github.com/users/octocat/repos",
                                                                                                                  "events_url": "https://api.github.com/users/octocat/events{/privacy}",
                                                                                                                  "received_events_url": "https://api.github.com/users/octocat/received_events",
                                                                                                                  "type": "User",
                                                                                                                  "site_admin": false
                                                                                                                },
                                                                                                                "name": "Hello-World",
                                                                                                                "full_name": "octocat/Hello-World",
                                                                                                                "description": "This your first repo!",
                                                                                                                "private": false,
                                                                                                                "fork": true,
                                                                                                                "url": "https://api.github.com/repos/octocat/Hello-World",
                                                                                                                "html_url": "https://github.com/octocat/Hello-World",
                                                                                                                "archive_url": "http://api.github.com/repos/octocat/Hello-World/{archive_format}{/ref}",
                                                                                                                "assignees_url": "http://api.github.com/repos/octocat/Hello-World/assignees{/user}",
                                                                                                                "blobs_url": "http://api.github.com/repos/octocat/Hello-World/git/blobs{/sha}",
                                                                                                                "branches_url": "http://api.github.com/repos/octocat/Hello-World/branches{/branch}",
                                                                                                                "clone_url": "https://github.com/octocat/Hello-World.git",
                                                                                                                "collaborators_url": "http://api.github.com/repos/octocat/Hello-World/collaborators{/collaborator}",
                                                                                                                "comments_url": "http://api.github.com/repos/octocat/Hello-World/comments{/number}",
                                                                                                                "commits_url": "http://api.github.com/repos/octocat/Hello-World/commits{/sha}",
                                                                                                                "compare_url": "http://api.github.com/repos/octocat/Hello-World/compare/{base}...{head}",
                                                                                                                "contents_url": "http://api.github.com/repos/octocat/Hello-World/contents/{+path}",
                                                                                                                "contributors_url": "http://api.github.com/repos/octocat/Hello-World/contributors",
                                                                                                                "deployments_url": "http://api.github.com/repos/octocat/Hello-World/deployments",
                                                                                                                "downloads_url": "http://api.github.com/repos/octocat/Hello-World/downloads",
                                                                                                                "events_url": "http://api.github.com/repos/octocat/Hello-World/events",
                                                                                                                "forks_url": "http://api.github.com/repos/octocat/Hello-World/forks",
                                                                                                                "git_commits_url": "http://api.github.com/repos/octocat/Hello-World/git/commits{/sha}",
                                                                                                                "git_refs_url": "http://api.github.com/repos/octocat/Hello-World/git/refs{/sha}",
                                                                                                                "git_tags_url": "http://api.github.com/repos/octocat/Hello-World/git/tags{/sha}",
                                                                                                                "git_url": "git:github.com/octocat/Hello-World.git",
                                                                                                                "hooks_url": "http://api.github.com/repos/octocat/Hello-World/hooks",
                                                                                                                "issue_comment_url": "http://api.github.com/repos/octocat/Hello-World/issues/comments{/number}",
                                                                                                                "issue_events_url": "http://api.github.com/repos/octocat/Hello-World/issues/events{/number}",
                                                                                                                "issues_url": "http://api.github.com/repos/octocat/Hello-World/issues{/number}",
                                                                                                                "keys_url": "http://api.github.com/repos/octocat/Hello-World/keys{/key_id}",
                                                                                                                "labels_url": "http://api.github.com/repos/octocat/Hello-World/labels{/name}",
                                                                                                                "languages_url": "http://api.github.com/repos/octocat/Hello-World/languages",
                                                                                                                "merges_url": "http://api.github.com/repos/octocat/Hello-World/merges",
                                                                                                                "milestones_url": "http://api.github.com/repos/octocat/Hello-World/milestones{/number}",
                                                                                                                "mirror_url": "git:git.example.com/octocat/Hello-World",
                                                                                                                "notifications_url": "http://api.github.com/repos/octocat/Hello-World/notifications{?since,all,participating}",
                                                                                                                "pulls_url": "http://api.github.com/repos/octocat/Hello-World/pulls{/number}",
                                                                                                                "releases_url": "http://api.github.com/repos/octocat/Hello-World/releases{/id}",
                                                                                                                "ssh_url": "git@github.com:octocat/Hello-World.git",
                                                                                                                "stargazers_url": "http://api.github.com/repos/octocat/Hello-World/stargazers",
                                                                                                                "statuses_url": "http://api.github.com/repos/octocat/Hello-World/statuses/{sha}",
                                                                                                                "subscribers_url": "http://api.github.com/repos/octocat/Hello-World/subscribers",
                                                                                                                "subscription_url": "http://api.github.com/repos/octocat/Hello-World/subscription",
                                                                                                                "svn_url": "https://svn.github.com/octocat/Hello-World",
                                                                                                                "tags_url": "http://api.github.com/repos/octocat/Hello-World/tags",
                                                                                                                "teams_url": "http://api.github.com/repos/octocat/Hello-World/teams",
                                                                                                                "trees_url": "http://api.github.com/repos/octocat/Hello-World/git/trees{/sha}",
                                                                                                                "homepage": "https://github.com",
                                                                                                                "language": null,
                                                                                                                "forks_count": 9,
                                                                                                                "stargazers_count": 80,
                                                                                                                "watchers_count": 80,
                                                                                                                "size": 108,
                                                                                                                "default_branch": "master",
                                                                                                                "open_issues_count": 0,
                                                                                                                "topics": [
                                                                                                                  "octocat",
                                                                                                                  "atom",
                                                                                                                  "electron",
                                                                                                                  "API"
                                                                                                                ],
                                                                                                                "has_issues": true,
                                                                                                                "has_wiki": true,
                                                                                                                "has_pages": false,
                                                                                                                "has_downloads": true,
                                                                                                                "archived": false,
                                                                                                                "pushed_at": "2011-01-26T19:06:43Z",
                                                                                                                "created_at": "2011-01-26T19:01:12Z",
                                                                                                                "updated_at": "2011-01-26T19:14:43Z",
                                                                                                                "permissions": {
                                                                                                                  "admin": false,
                                                                                                                  "push": false,
                                                                                                                  "pull": true
                                                                                                                },
                                                                                                                "allow_rebase_merge": true,
                                                                                                                "allow_squash_merge": true,
                                                                                                                "allow_merge_commit": true,
                                                                                                                "subscribers_count": 42,
                                                                                                                "network_count": 0
                                                                                                              },
                                                                                                              "invitee": {
                                                                                                                "login": "octocat",
                                                                                                                "id": 1,
                                                                                                                "avatar_url": "https://github.com/images/error/octocat_happy.gif",
                                                                                                                "gravatar_id": "",
                                                                                                                "url": "https://api.github.com/users/octocat",
                                                                                                                "html_url": "https://github.com/octocat",
                                                                                                                "followers_url": "https://api.github.com/users/octocat/followers",
                                                                                                                "following_url": "https://api.github.com/users/octocat/following{/other_user}",
                                                                                                                "gists_url": "https://api.github.com/users/octocat/gists{/gist_id}",
                                                                                                                "starred_url": "https://api.github.com/users/octocat/starred{/owner}{/repo}",
                                                                                                                "subscriptions_url": "https://api.github.com/users/octocat/subscriptions",
                                                                                                                "organizations_url": "https://api.github.com/users/octocat/orgs",
                                                                                                                "repos_url": "https://api.github.com/users/octocat/repos",
                                                                                                                "events_url": "https://api.github.com/users/octocat/events{/privacy}",
                                                                                                                "received_events_url": "https://api.github.com/users/octocat/received_events",
                                                                                                                "type": "User",
                                                                                                                "site_admin": false
                                                                                                              },
                                                                                                              "inviter": {
                                                                                                                "login": "octocat",
                                                                                                                "id": 1,
                                                                                                                "avatar_url": "https://github.com/images/error/octocat_happy.gif",
                                                                                                                "gravatar_id": "",
                                                                                                                "url": "https://api.github.com/users/octocat",
                                                                                                                "html_url": "https://github.com/octocat",
                                                                                                                "followers_url": "https://api.github.com/users/octocat/followers",
                                                                                                                "following_url": "https://api.github.com/users/octocat/following{/other_user}",
                                                                                                                "gists_url": "https://api.github.com/users/octocat/gists{/gist_id}",
                                                                                                                "starred_url": "https://api.github.com/users/octocat/starred{/owner}{/repo}",
                                                                                                                "subscriptions_url": "https://api.github.com/users/octocat/subscriptions",
                                                                                                                "organizations_url": "https://api.github.com/users/octocat/orgs",
                                                                                                                "repos_url": "https://api.github.com/users/octocat/repos",
                                                                                                                "events_url": "https://api.github.com/users/octocat/events{/privacy}",
                                                                                                                "received_events_url": "https://api.github.com/users/octocat/received_events",
                                                                                                                "type": "User",
                                                                                                                "site_admin": false
                                                                                                              },
                                                                                                              "permissions": "write",
                                                                                                              "created_at": "2016-06-13T14:52:50-05:00",
                                                                                                              "url": "https://api.github.com/user/repository_invitations/1296269",
                                                                                                              "html_url": "https://github.com/octocat/Hello-World/invitations"
                                                                                                            }
                                                                                                          ]
                                                                                                          

                                                                                                          Delete a repository invitation

                                                                                                          DELETE /repos/:owner/:repo/invitations/:invitation_id
                                                                                                          

                                                                                                          Response

                                                                                                          Status: 204 No Content
                                                                                                          

                                                                                                          Update a repository invitation

                                                                                                          PATCH /repos/:owner/:repo/invitations/:invitation_id
                                                                                                          

                                                                                                          Input

                                                                                                          Name Type Description
                                                                                                          permissions string The permissions that the associated user will have on the repository. Valid values are read, write, and admin.

                                                                                                          Response

                                                                                                          Status: 200 OK
                                                                                                          
                                                                                                          {
                                                                                                            "id": 1,
                                                                                                            "repository": {
                                                                                                              "id": 1296269,
                                                                                                              "owner": {
                                                                                                                "login": "octocat",
                                                                                                                "id": 1,
                                                                                                                "avatar_url": "https://github.com/images/error/octocat_happy.gif",
                                                                                                                "gravatar_id": "",
                                                                                                                "url": "https://api.github.com/users/octocat",
                                                                                                                "html_url": "https://github.com/octocat",
                                                                                                                "followers_url": "https://api.github.com/users/octocat/followers",
                                                                                                                "following_url": "https://api.github.com/users/octocat/following{/other_user}",
                                                                                                                "gists_url": "https://api.github.com/users/octocat/gists{/gist_id}",
                                                                                                                "starred_url": "https://api.github.com/users/octocat/starred{/owner}{/repo}",
                                                                                                                "subscriptions_url": "https://api.github.com/users/octocat/subscriptions",
                                                                                                                "organizations_url": "https://api.github.com/users/octocat/orgs",
                                                                                                                "repos_url": "https://api.github.com/users/octocat/repos",
                                                                                                                "events_url": "https://api.github.com/users/octocat/events{/privacy}",
                                                                                                                "received_events_url": "https://api.github.com/users/octocat/received_events",
                                                                                                                "type": "User",
                                                                                                                "site_admin": false
                                                                                                              },
                                                                                                              "name": "Hello-World",
                                                                                                              "full_name": "octocat/Hello-World",
                                                                                                              "description": "This your first repo!",
                                                                                                              "private": false,
                                                                                                              "fork": true,
                                                                                                              "url": "https://api.github.com/repos/octocat/Hello-World",
                                                                                                              "html_url": "https://github.com/octocat/Hello-World",
                                                                                                              "archive_url": "http://api.github.com/repos/octocat/Hello-World/{archive_format}{/ref}",
                                                                                                              "assignees_url": "http://api.github.com/repos/octocat/Hello-World/assignees{/user}",
                                                                                                              "blobs_url": "http://api.github.com/repos/octocat/Hello-World/git/blobs{/sha}",
                                                                                                              "branches_url": "http://api.github.com/repos/octocat/Hello-World/branches{/branch}",
                                                                                                              "clone_url": "https://github.com/octocat/Hello-World.git",
                                                                                                              "collaborators_url": "http://api.github.com/repos/octocat/Hello-World/collaborators{/collaborator}",
                                                                                                              "comments_url": "http://api.github.com/repos/octocat/Hello-World/comments{/number}",
                                                                                                              "commits_url": "http://api.github.com/repos/octocat/Hello-World/commits{/sha}",
                                                                                                              "compare_url": "http://api.github.com/repos/octocat/Hello-World/compare/{base}...{head}",
                                                                                                              "contents_url": "http://api.github.com/repos/octocat/Hello-World/contents/{+path}",
                                                                                                              "contributors_url": "http://api.github.com/repos/octocat/Hello-World/contributors",
                                                                                                              "deployments_url": "http://api.github.com/repos/octocat/Hello-World/deployments",
                                                                                                              "downloads_url": "http://api.github.com/repos/octocat/Hello-World/downloads",
                                                                                                              "events_url": "http://api.github.com/repos/octocat/Hello-World/events",
                                                                                                              "forks_url": "http://api.github.com/repos/octocat/Hello-World/forks",
                                                                                                              "git_commits_url": "http://api.github.com/repos/octocat/Hello-World/git/commits{/sha}",
                                                                                                              "git_refs_url": "http://api.github.com/repos/octocat/Hello-World/git/refs{/sha}",
                                                                                                              "git_tags_url": "http://api.github.com/repos/octocat/Hello-World/git/tags{/sha}",
                                                                                                              "git_url": "git:github.com/octocat/Hello-World.git",
                                                                                                              "hooks_url": "http://api.github.com/repos/octocat/Hello-World/hooks",
                                                                                                              "issue_comment_url": "http://api.github.com/repos/octocat/Hello-World/issues/comments{/number}",
                                                                                                              "issue_events_url": "http://api.github.com/repos/octocat/Hello-World/issues/events{/number}",
                                                                                                              "issues_url": "http://api.github.com/repos/octocat/Hello-World/issues{/number}",
                                                                                                              "keys_url": "http://api.github.com/repos/octocat/Hello-World/keys{/key_id}",
                                                                                                              "labels_url": "http://api.github.com/repos/octocat/Hello-World/labels{/name}",
                                                                                                              "languages_url": "http://api.github.com/repos/octocat/Hello-World/languages",
                                                                                                              "merges_url": "http://api.github.com/repos/octocat/Hello-World/merges",
                                                                                                              "milestones_url": "http://api.github.com/repos/octocat/Hello-World/milestones{/number}",
                                                                                                              "mirror_url": "git:git.example.com/octocat/Hello-World",
                                                                                                              "notifications_url": "http://api.github.com/repos/octocat/Hello-World/notifications{?since,all,participating}",
                                                                                                              "pulls_url": "http://api.github.com/repos/octocat/Hello-World/pulls{/number}",
                                                                                                              "releases_url": "http://api.github.com/repos/octocat/Hello-World/releases{/id}",
                                                                                                              "ssh_url": "git@github.com:octocat/Hello-World.git",
                                                                                                              "stargazers_url": "http://api.github.com/repos/octocat/Hello-World/stargazers",
                                                                                                              "statuses_url": "http://api.github.com/repos/octocat/Hello-World/statuses/{sha}",
                                                                                                              "subscribers_url": "http://api.github.com/repos/octocat/Hello-World/subscribers",
                                                                                                              "subscription_url": "http://api.github.com/repos/octocat/Hello-World/subscription",
                                                                                                              "svn_url": "https://svn.github.com/octocat/Hello-World",
                                                                                                              "tags_url": "http://api.github.com/repos/octocat/Hello-World/tags",
                                                                                                              "teams_url": "http://api.github.com/repos/octocat/Hello-World/teams",
                                                                                                              "trees_url": "http://api.github.com/repos/octocat/Hello-World/git/trees{/sha}",
                                                                                                              "homepage": "https://github.com",
                                                                                                              "language": null,
                                                                                                              "forks_count": 9,
                                                                                                              "stargazers_count": 80,
                                                                                                              "watchers_count": 80,
                                                                                                              "size": 108,
                                                                                                              "default_branch": "master",
                                                                                                              "open_issues_count": 0,
                                                                                                              "topics": [
                                                                                                                "octocat",
                                                                                                                "atom",
                                                                                                                "electron",
                                                                                                                "API"
                                                                                                              ],
                                                                                                              "has_issues": true,
                                                                                                              "has_wiki": true,
                                                                                                              "has_pages": false,
                                                                                                              "has_downloads": true,
                                                                                                              "archived": false,
                                                                                                              "pushed_at": "2011-01-26T19:06:43Z",
                                                                                                              "created_at": "2011-01-26T19:01:12Z",
                                                                                                              "updated_at": "2011-01-26T19:14:43Z",
                                                                                                              "permissions": {
                                                                                                                "admin": false,
                                                                                                                "push": false,
                                                                                                                "pull": true
                                                                                                              },
                                                                                                              "allow_rebase_merge": true,
                                                                                                              "allow_squash_merge": true,
                                                                                                              "allow_merge_commit": true,
                                                                                                              "subscribers_count": 42,
                                                                                                              "network_count": 0
                                                                                                            },
                                                                                                            "invitee": {
                                                                                                              "login": "octocat",
                                                                                                              "id": 1,
                                                                                                              "avatar_url": "https://github.com/images/error/octocat_happy.gif",
                                                                                                              "gravatar_id": "",
                                                                                                              "url": "https://api.github.com/users/octocat",
                                                                                                              "html_url": "https://github.com/octocat",
                                                                                                              "followers_url": "https://api.github.com/users/octocat/followers",
                                                                                                              "following_url": "https://api.github.com/users/octocat/following{/other_user}",
                                                                                                              "gists_url": "https://api.github.com/users/octocat/gists{/gist_id}",
                                                                                                              "starred_url": "https://api.github.com/users/octocat/starred{/owner}{/repo}",
                                                                                                              "subscriptions_url": "https://api.github.com/users/octocat/subscriptions",
                                                                                                              "organizations_url": "https://api.github.com/users/octocat/orgs",
                                                                                                              "repos_url": "https://api.github.com/users/octocat/repos",
                                                                                                              "events_url": "https://api.github.com/users/octocat/events{/privacy}",
                                                                                                              "received_events_url": "https://api.github.com/users/octocat/received_events",
                                                                                                              "type": "User",
                                                                                                              "site_admin": false
                                                                                                            },
                                                                                                            "inviter": {
                                                                                                              "login": "octocat",
                                                                                                              "id": 1,
                                                                                                              "avatar_url": "https://github.com/images/error/octocat_happy.gif",
                                                                                                              "gravatar_id": "",
                                                                                                              "url": "https://api.github.com/users/octocat",
                                                                                                              "html_url": "https://github.com/octocat",
                                                                                                              "followers_url": "https://api.github.com/users/octocat/followers",
                                                                                                              "following_url": "https://api.github.com/users/octocat/following{/other_user}",
                                                                                                              "gists_url": "https://api.github.com/users/octocat/gists{/gist_id}",
                                                                                                              "starred_url": "https://api.github.com/users/octocat/starred{/owner}{/repo}",
                                                                                                              "subscriptions_url": "https://api.github.com/users/octocat/subscriptions",
                                                                                                              "organizations_url": "https://api.github.com/users/octocat/orgs",
                                                                                                              "repos_url": "https://api.github.com/users/octocat/repos",
                                                                                                              "events_url": "https://api.github.com/users/octocat/events{/privacy}",
                                                                                                              "received_events_url": "https://api.github.com/users/octocat/received_events",
                                                                                                              "type": "User",
                                                                                                              "site_admin": false
                                                                                                            },
                                                                                                            "permissions": "write",
                                                                                                            "created_at": "2016-06-13T14:52:50-05:00",
                                                                                                            "url": "https://api.github.com/user/repository_invitations/1296269",
                                                                                                            "html_url": "https://github.com/octocat/Hello-World/invitations"
                                                                                                          }
                                                                                                          

                                                                                                          List a user's repository invitations

                                                                                                          GET /user/repository_invitations
                                                                                                          

                                                                                                          When authenticating as a user, this endpoint will list all currently open repository invitations for that user.

                                                                                                          Response

                                                                                                          Status: 200 OK
                                                                                                          Link: <https://api.github.com/resource?page=2>; rel="next",
                                                                                                                <https://api.github.com/resource?page=5>; rel="last"
                                                                                                          
                                                                                                          [
                                                                                                            {
                                                                                                              "id": 1,
                                                                                                              "repository": {
                                                                                                                "id": 1296269,
                                                                                                                "owner": {
                                                                                                                  "login": "octocat",
                                                                                                                  "id": 1,
                                                                                                                  "avatar_url": "https://github.com/images/error/octocat_happy.gif",
                                                                                                                  "gravatar_id": "",
                                                                                                                  "url": "https://api.github.com/users/octocat",
                                                                                                                  "html_url": "https://github.com/octocat",
                                                                                                                  "followers_url": "https://api.github.com/users/octocat/followers",
                                                                                                                  "following_url": "https://api.github.com/users/octocat/following{/other_user}",
                                                                                                                  "gists_url": "https://api.github.com/users/octocat/gists{/gist_id}",
                                                                                                                  "starred_url": "https://api.github.com/users/octocat/starred{/owner}{/repo}",
                                                                                                                  "subscriptions_url": "https://api.github.com/users/octocat/subscriptions",
                                                                                                                  "organizations_url": "https://api.github.com/users/octocat/orgs",
                                                                                                                  "repos_url": "https://api.github.com/users/octocat/repos",
                                                                                                                  "events_url": "https://api.github.com/users/octocat/events{/privacy}",
                                                                                                                  "received_events_url": "https://api.github.com/users/octocat/received_events",
                                                                                                                  "type": "User",
                                                                                                                  "site_admin": false
                                                                                                                },
                                                                                                                "name": "Hello-World",
                                                                                                                "full_name": "octocat/Hello-World",
                                                                                                                "description": "This your first repo!",
                                                                                                                "private": false,
                                                                                                                "fork": true,
                                                                                                                "url": "https://api.github.com/repos/octocat/Hello-World",
                                                                                                                "html_url": "https://github.com/octocat/Hello-World",
                                                                                                                "archive_url": "http://api.github.com/repos/octocat/Hello-World/{archive_format}{/ref}",
                                                                                                                "assignees_url": "http://api.github.com/repos/octocat/Hello-World/assignees{/user}",
                                                                                                                "blobs_url": "http://api.github.com/repos/octocat/Hello-World/git/blobs{/sha}",
                                                                                                                "branches_url": "http://api.github.com/repos/octocat/Hello-World/branches{/branch}",
                                                                                                                "clone_url": "https://github.com/octocat/Hello-World.git",
                                                                                                                "collaborators_url": "http://api.github.com/repos/octocat/Hello-World/collaborators{/collaborator}",
                                                                                                                "comments_url": "http://api.github.com/repos/octocat/Hello-World/comments{/number}",
                                                                                                                "commits_url": "http://api.github.com/repos/octocat/Hello-World/commits{/sha}",
                                                                                                                "compare_url": "http://api.github.com/repos/octocat/Hello-World/compare/{base}...{head}",
                                                                                                                "contents_url": "http://api.github.com/repos/octocat/Hello-World/contents/{+path}",
                                                                                                                "contributors_url": "http://api.github.com/repos/octocat/Hello-World/contributors",
                                                                                                                "deployments_url": "http://api.github.com/repos/octocat/Hello-World/deployments",
                                                                                                                "downloads_url": "http://api.github.com/repos/octocat/Hello-World/downloads",
                                                                                                                "events_url": "http://api.github.com/repos/octocat/Hello-World/events",
                                                                                                                "forks_url": "http://api.github.com/repos/octocat/Hello-World/forks",
                                                                                                                "git_commits_url": "http://api.github.com/repos/octocat/Hello-World/git/commits{/sha}",
                                                                                                                "git_refs_url": "http://api.github.com/repos/octocat/Hello-World/git/refs{/sha}",
                                                                                                                "git_tags_url": "http://api.github.com/repos/octocat/Hello-World/git/tags{/sha}",
                                                                                                                "git_url": "git:github.com/octocat/Hello-World.git",
                                                                                                                "hooks_url": "http://api.github.com/repos/octocat/Hello-World/hooks",
                                                                                                                "issue_comment_url": "http://api.github.com/repos/octocat/Hello-World/issues/comments{/number}",
                                                                                                                "issue_events_url": "http://api.github.com/repos/octocat/Hello-World/issues/events{/number}",
                                                                                                                "issues_url": "http://api.github.com/repos/octocat/Hello-World/issues{/number}",
                                                                                                                "keys_url": "http://api.github.com/repos/octocat/Hello-World/keys{/key_id}",
                                                                                                                "labels_url": "http://api.github.com/repos/octocat/Hello-World/labels{/name}",
                                                                                                                "languages_url": "http://api.github.com/repos/octocat/Hello-World/languages",
                                                                                                                "merges_url": "http://api.github.com/repos/octocat/Hello-World/merges",
                                                                                                                "milestones_url": "http://api.github.com/repos/octocat/Hello-World/milestones{/number}",
                                                                                                                "mirror_url": "git:git.example.com/octocat/Hello-World",
                                                                                                                "notifications_url": "http://api.github.com/repos/octocat/Hello-World/notifications{?since,all,participating}",
                                                                                                                "pulls_url": "http://api.github.com/repos/octocat/Hello-World/pulls{/number}",
                                                                                                                "releases_url": "http://api.github.com/repos/octocat/Hello-World/releases{/id}",
                                                                                                                "ssh_url": "git@github.com:octocat/Hello-World.git",
                                                                                                                "stargazers_url": "http://api.github.com/repos/octocat/Hello-World/stargazers",
                                                                                                                "statuses_url": "http://api.github.com/repos/octocat/Hello-World/statuses/{sha}",
                                                                                                                "subscribers_url": "http://api.github.com/repos/octocat/Hello-World/subscribers",
                                                                                                                "subscription_url": "http://api.github.com/repos/octocat/Hello-World/subscription",
                                                                                                                "svn_url": "https://svn.github.com/octocat/Hello-World",
                                                                                                                "tags_url": "http://api.github.com/repos/octocat/Hello-World/tags",
                                                                                                                "teams_url": "http://api.github.com/repos/octocat/Hello-World/teams",
                                                                                                                "trees_url": "http://api.github.com/repos/octocat/Hello-World/git/trees{/sha}",
                                                                                                                "homepage": "https://github.com",
                                                                                                                "language": null,
                                                                                                                "forks_count": 9,
                                                                                                                "stargazers_count": 80,
                                                                                                                "watchers_count": 80,
                                                                                                                "size": 108,
                                                                                                                "default_branch": "master",
                                                                                                                "open_issues_count": 0,
                                                                                                                "topics": [
                                                                                                                  "octocat",
                                                                                                                  "atom",
                                                                                                                  "electron",
                                                                                                                  "API"
                                                                                                                ],
                                                                                                                "has_issues": true,
                                                                                                                "has_wiki": true,
                                                                                                                "has_pages": false,
                                                                                                                "has_downloads": true,
                                                                                                                "archived": false,
                                                                                                                "pushed_at": "2011-01-26T19:06:43Z",
                                                                                                                "created_at": "2011-01-26T19:01:12Z",
                                                                                                                "updated_at": "2011-01-26T19:14:43Z",
                                                                                                                "permissions": {
                                                                                                                  "admin": false,
                                                                                                                  "push": false,
                                                                                                                  "pull": true
                                                                                                                },
                                                                                                                "allow_rebase_merge": true,
                                                                                                                "allow_squash_merge": true,
                                                                                                                "allow_merge_commit": true,
                                                                                                                "subscribers_count": 42,
                                                                                                                "network_count": 0
                                                                                                              },
                                                                                                              "invitee": {
                                                                                                                "login": "octocat",
                                                                                                                "id": 1,
                                                                                                                "avatar_url": "https://github.com/images/error/octocat_happy.gif",
                                                                                                                "gravatar_id": "",
                                                                                                                "url": "https://api.github.com/users/octocat",
                                                                                                                "html_url": "https://github.com/octocat",
                                                                                                                "followers_url": "https://api.github.com/users/octocat/followers",
                                                                                                                "following_url": "https://api.github.com/users/octocat/following{/other_user}",
                                                                                                                "gists_url": "https://api.github.com/users/octocat/gists{/gist_id}",
                                                                                                                "starred_url": "https://api.github.com/users/octocat/starred{/owner}{/repo}",
                                                                                                                "subscriptions_url": "https://api.github.com/users/octocat/subscriptions",
                                                                                                                "organizations_url": "https://api.github.com/users/octocat/orgs",
                                                                                                                "repos_url": "https://api.github.com/users/octocat/repos",
                                                                                                                "events_url": "https://api.github.com/users/octocat/events{/privacy}",
                                                                                                                "received_events_url": "https://api.github.com/users/octocat/received_events",
                                                                                                                "type": "User",
                                                                                                                "site_admin": false
                                                                                                              },
                                                                                                              "inviter": {
                                                                                                                "login": "octocat",
                                                                                                                "id": 1,
                                                                                                                "avatar_url": "https://github.com/images/error/octocat_happy.gif",
                                                                                                                "gravatar_id": "",
                                                                                                                "url": "https://api.github.com/users/octocat",
                                                                                                                "html_url": "https://github.com/octocat",
                                                                                                                "followers_url": "https://api.github.com/users/octocat/followers",
                                                                                                                "following_url": "https://api.github.com/users/octocat/following{/other_user}",
                                                                                                                "gists_url": "https://api.github.com/users/octocat/gists{/gist_id}",
                                                                                                                "starred_url": "https://api.github.com/users/octocat/starred{/owner}{/repo}",
                                                                                                                "subscriptions_url": "https://api.github.com/users/octocat/subscriptions",
                                                                                                                "organizations_url": "https://api.github.com/users/octocat/orgs",
                                                                                                                "repos_url": "https://api.github.com/users/octocat/repos",
                                                                                                                "events_url": "https://api.github.com/users/octocat/events{/privacy}",
                                                                                                                "received_events_url": "https://api.github.com/users/octocat/received_events",
                                                                                                                "type": "User",
                                                                                                                "site_admin": false
                                                                                                              },
                                                                                                              "permissions": "write",
                                                                                                              "created_at": "2016-06-13T14:52:50-05:00",
                                                                                                              "url": "https://api.github.com/user/repository_invitations/1296269",
                                                                                                              "html_url": "https://github.com/octocat/Hello-World/invitations"
                                                                                                            }
                                                                                                          ]
                                                                                                          

                                                                                                          Accept a repository invitation

                                                                                                          PATCH /user/repository_invitations/:invitation_id
                                                                                                          

                                                                                                          Response

                                                                                                          Status: 204 No Content
                                                                                                          

                                                                                                          Decline a repository invitation

                                                                                                          DELETE /user/repository_invitations/:invitation_id
                                                                                                          

                                                                                                          Response

                                                                                                          Status: 204 No Content
                                                                                                          
                                                                                                          tmp/developer.github.com/v3/repos/keys/index.html Deploy Keys | GitHub Developer Guide

                                                                                                          Deploy Keys

                                                                                                          List deploy keys

                                                                                                          GET /repos/:owner/:repo/keys
                                                                                                          

                                                                                                          Response

                                                                                                          Status: 200 OK
                                                                                                          Link: <https://api.github.com/resource?page=2>; rel="next",
                                                                                                                <https://api.github.com/resource?page=5>; rel="last"
                                                                                                          
                                                                                                          [
                                                                                                            {
                                                                                                              "id": 1,
                                                                                                              "key": "ssh-rsa AAA...",
                                                                                                              "url": "https://api.github.com/repos/octocat/Hello-World/keys/1",
                                                                                                              "title": "octocat@octomac",
                                                                                                              "verified": true,
                                                                                                              "created_at": "2014-12-10T15:53:42Z",
                                                                                                              "read_only": true
                                                                                                            }
                                                                                                          ]
                                                                                                          

                                                                                                          Get a deploy key

                                                                                                          GET /repos/:owner/:repo/keys/:id
                                                                                                          

                                                                                                          Response

                                                                                                          Status: 200 OK
                                                                                                          
                                                                                                          {
                                                                                                            "id": 1,
                                                                                                            "key": "ssh-rsa AAA...",
                                                                                                            "url": "https://api.github.com/repos/octocat/Hello-World/keys/1",
                                                                                                            "title": "octocat@octomac",
                                                                                                            "verified": true,
                                                                                                            "created_at": "2014-12-10T15:53:42Z",
                                                                                                            "read_only": true
                                                                                                          }
                                                                                                          

                                                                                                          Add a new deploy key

                                                                                                          POST /repos/:owner/:repo/keys
                                                                                                          

                                                                                                          Parameters

                                                                                                          Name Type Description
                                                                                                          title string A name for the key.
                                                                                                          key string The contents of the key.
                                                                                                          read_only boolean If true, the key will only be able to read repository contents. Otherwise, the key will be able to read and write.

                                                                                                          Example

                                                                                                          Here's how you can create a read-only deploy key:

                                                                                                          {
                                                                                                            "title": "octocat@octomac",
                                                                                                            "key": "ssh-rsa AAA...",
                                                                                                            "read_only": true
                                                                                                          }
                                                                                                          

                                                                                                          Response

                                                                                                          Status: 201 Created
                                                                                                          Location: https://api.github.com/repos/octocat/Hello-World/keys/1
                                                                                                          
                                                                                                          {
                                                                                                            "id": 1,
                                                                                                            "key": "ssh-rsa AAA...",
                                                                                                            "url": "https://api.github.com/repos/octocat/Hello-World/keys/1",
                                                                                                            "title": "octocat@octomac",
                                                                                                            "verified": true,
                                                                                                            "created_at": "2014-12-10T15:53:42Z",
                                                                                                            "read_only": true
                                                                                                          }
                                                                                                          

                                                                                                          Edit a deploy key

                                                                                                          Deploy keys are immutable. If you need to update a key, remove the key and create a new one instead.

                                                                                                          Remove a deploy key

                                                                                                          DELETE /repos/:owner/:repo/keys/:id
                                                                                                          

                                                                                                          Response

                                                                                                          Status: 204 No Content
                                                                                                          
                                                                                                          tmp/developer.github.com/v3/repos/merging/index.html Merging | GitHub Developer Guide

                                                                                                          Merging

                                                                                                          The Repo Merging API supports merging branches in a repository. This accomplishes essentially the same thing as merging one branch into another in a local repository and then pushing to GitHub. The benefit is that the merge is done on the server side and a local repository is not needed. This makes it more appropriate for automation and other tools where maintaining local repositories would be cumbersome and inefficient.

                                                                                                          The authenticated user will be the author of any merges done through this endpoint.

                                                                                                          Perform a merge

                                                                                                          POST /repos/:owner/:repo/merges
                                                                                                          

                                                                                                          Input

                                                                                                          Name Type Description
                                                                                                          base string Required. The name of the base branch that the head will be merged into.
                                                                                                          head string Required. The head to merge. This can be a branch name or a commit SHA1.
                                                                                                          commit_message string Commit message to use for the merge commit. If omitted, a default message will be used.
                                                                                                          {
                                                                                                            "base": "master",
                                                                                                            "head": "cool_feature",
                                                                                                            "commit_message": "Shipped cool_feature!"
                                                                                                          }
                                                                                                          

                                                                                                          Successful Response (The resulting merge commit)

                                                                                                          Status: 201 Created
                                                                                                          
                                                                                                          {
                                                                                                            "sha": "7fd1a60b01f91b314f59955a4e4d4e80d8edf11d",
                                                                                                            "commit": {
                                                                                                              "author": {
                                                                                                                "name": "The Octocat",
                                                                                                                "date": "2012-03-06T15:06:50-08:00",
                                                                                                                "email": "octocat@nowhere.com"
                                                                                                              },
                                                                                                              "committer": {
                                                                                                                "name": "The Octocat",
                                                                                                                "date": "2012-03-06T15:06:50-08:00",
                                                                                                                "email": "octocat@nowhere.com"
                                                                                                              },
                                                                                                              "message": "Shipped cool_feature!",
                                                                                                              "tree": {
                                                                                                                "sha": "b4eecafa9be2f2006ce1b709d6857b07069b4608",
                                                                                                                "url": "https://api.github.com/repos/octocat/Hello-World/git/trees/b4eecafa9be2f2006ce1b709d6857b07069b4608"
                                                                                                              },
                                                                                                              "url": "https://api.github.com/repos/octocat/Hello-World/git/commits/7fd1a60b01f91b314f59955a4e4d4e80d8edf11d",
                                                                                                              "comment_count": 0,
                                                                                                              "verification": {
                                                                                                                "verified": false,
                                                                                                                "reason": "unsigned",
                                                                                                                "signature": null,
                                                                                                                "payload": null
                                                                                                              }
                                                                                                            },
                                                                                                            "url": "https://api.github.com/repos/octocat/Hello-World/commits/7fd1a60b01f91b314f59955a4e4d4e80d8edf11d",
                                                                                                            "html_url": "https://github.com/octocat/Hello-World/commit/7fd1a60b01f91b314f59955a4e4d4e80d8edf11d",
                                                                                                            "comments_url": "https://api.github.com/repos/octocat/Hello-World/commits/7fd1a60b01f91b314f59955a4e4d4e80d8edf11d/comments",
                                                                                                            "author": {
                                                                                                              "login": "octocat",
                                                                                                              "id": 583231,
                                                                                                              "avatar_url": "https://secure.gravatar.com/avatar/7ad39074b0584bc555d0417ae3e7d974?d=https://a248.e.akamai.net/assets.github.com%2Fimages%2Fgravatars%2Fgravatar-140.png",
                                                                                                              "gravatar_id": "",
                                                                                                              "url": "https://api.github.com/users/octocat",
                                                                                                              "html_url": "https://github.com/octocat",
                                                                                                              "followers_url": "https://api.github.com/users/octocat/followers",
                                                                                                              "following_url": "https://api.github.com/users/octocat/following",
                                                                                                              "gists_url": "https://api.github.com/users/octocat/gists{/gist_id}",
                                                                                                              "starred_url": "https://api.github.com/users/octocat/starred{/owner}{/repo}",
                                                                                                              "subscriptions_url": "https://api.github.com/users/octocat/subscriptions",
                                                                                                              "organizations_url": "https://api.github.com/users/octocat/orgs",
                                                                                                              "repos_url": "https://api.github.com/users/octocat/repos",
                                                                                                              "events_url": "https://api.github.com/users/octocat/events{/privacy}",
                                                                                                              "received_events_url": "https://api.github.com/users/octocat/received_events",
                                                                                                              "type": "User"
                                                                                                            },
                                                                                                            "committer": {
                                                                                                              "login": "octocat",
                                                                                                              "id": 583231,
                                                                                                              "avatar_url": "https://secure.gravatar.com/avatar/7ad39074b0584bc555d0417ae3e7d974?d=https://a248.e.akamai.net/assets.github.com%2Fimages%2Fgravatars%2Fgravatar-140.png",
                                                                                                              "gravatar_id": "",
                                                                                                              "url": "https://api.github.com/users/octocat",
                                                                                                              "html_url": "https://github.com/octocat",
                                                                                                              "followers_url": "https://api.github.com/users/octocat/followers",
                                                                                                              "following_url": "https://api.github.com/users/octocat/following",
                                                                                                              "gists_url": "https://api.github.com/users/octocat/gists{/gist_id}",
                                                                                                              "starred_url": "https://api.github.com/users/octocat/starred{/owner}{/repo}",
                                                                                                              "subscriptions_url": "https://api.github.com/users/octocat/subscriptions",
                                                                                                              "organizations_url": "https://api.github.com/users/octocat/orgs",
                                                                                                              "repos_url": "https://api.github.com/users/octocat/repos",
                                                                                                              "events_url": "https://api.github.com/users/octocat/events{/privacy}",
                                                                                                              "received_events_url": "https://api.github.com/users/octocat/received_events",
                                                                                                              "type": "User"
                                                                                                            },
                                                                                                            "parents": [
                                                                                                              {
                                                                                                                "sha": "553c2077f0edc3d5dc5d17262f6aa498e69d6f8e",
                                                                                                                "url": "https://api.github.com/repos/octocat/Hello-World/commits/553c2077f0edc3d5dc5d17262f6aa498e69d6f8e"
                                                                                                              },
                                                                                                              {
                                                                                                                "sha": "762941318ee16e59dabbacb1b4049eec22f0d303",
                                                                                                                "url": "https://api.github.com/repos/octocat/Hello-World/commits/762941318ee16e59dabbacb1b4049eec22f0d303"
                                                                                                              }
                                                                                                            ]
                                                                                                          }
                                                                                                          

                                                                                                          No-op response (base already contains the head, nothing to merge)

                                                                                                          Status: 204 No Content
                                                                                                          

                                                                                                          Merge conflict response

                                                                                                          Status: 409 Conflict
                                                                                                          
                                                                                                          {
                                                                                                            "message": "Merge Conflict"
                                                                                                          }
                                                                                                          

                                                                                                          Missing base response

                                                                                                          Status: 404 Not Found
                                                                                                          
                                                                                                          {
                                                                                                            "message": "Base does not exist"
                                                                                                          }
                                                                                                          

                                                                                                          Missing head response

                                                                                                          Status: 404 Not Found
                                                                                                          
                                                                                                          {
                                                                                                            "message": "Head does not exist"
                                                                                                          }
                                                                                                          
                                                                                                          tmp/developer.github.com/v3/repos/pages/index.html Pages | GitHub Developer Guide

                                                                                                          Pages

                                                                                                          The GitHub Pages API retrieves information about your GitHub Pages configuration, and the statuses of your builds. Information about the site and the builds can only be accessed by authenticated owners, even though the websites are public.

                                                                                                          In JSON responses, status can be one of:

                                                                                                          • null, which means the site has yet to be built
                                                                                                          • queued, which means the build has been requested but not yet begun
                                                                                                          • building, which means the build is in progress
                                                                                                          • built, which means the site has been built
                                                                                                          • errored, which indicates an error occurred during the build

                                                                                                          Get information about a Pages site

                                                                                                          GET /repos/:owner/:repo/pages
                                                                                                          

                                                                                                          Note: The GitHub Pages API on GitHub is currently available for developers to preview. To access the API, you must provide a custom media type in the Accept header:

                                                                                                          application/vnd.github.mister-fantastic-preview+json
                                                                                                          

                                                                                                          Warning: The API may change without advance notice during the preview period. Preview features are not supported for production use. If you experience any issues, contact GitHub support.

                                                                                                          Responses during the preview period contain two additional fields:

                                                                                                          • html_url: The absolute URL (with scheme) to the rendered site. For example, https://username.github.io.
                                                                                                          • source: Information about the source branch and directory for the rendered site. The source field includes:
                                                                                                            • branch: The repo branch for site source files For example, master or gh-pages.
                                                                                                            • path: The repo directory from which the site publishes. Can be either / or /docs.

                                                                                                          Response

                                                                                                          Status: 200 OK
                                                                                                          
                                                                                                          {
                                                                                                            "url": "https://api.github.com/repos/github/developer.github.com/pages",
                                                                                                            "status": "built",
                                                                                                            "cname": "developer.github.com",
                                                                                                            "custom_404": false,
                                                                                                            "html_url": "https://developer.github.com",
                                                                                                            "source": {
                                                                                                              "branch": "master",
                                                                                                              "directory": "/"
                                                                                                            }
                                                                                                          }
                                                                                                          

                                                                                                          Request a page build

                                                                                                          POST /repos/:owner/:repo/pages/builds
                                                                                                          

                                                                                                          This endpoint is currently available for developers to preview. During the preview period, the API may change without advance notice.

                                                                                                          To access this endpoint during the preview period, you must provide a custom media type in the Accept header:

                                                                                                            application/vnd.github.mister-fantastic-preview+json
                                                                                                          

                                                                                                          You can request that your site be built from the latest revision on the default branch. This has the same effect as pushing a commit to your default branch, but does not require an additional commit. Manually triggering page builds can be helpful when diagnosing build warnings and failures.

                                                                                                          Build requests are limited to one concurrent build per repository and one concurrent build per requester. If you request a build while another is still in progress, the second request will be queued until the first completes.

                                                                                                          Response

                                                                                                          Status: 200 OK
                                                                                                          
                                                                                                          {
                                                                                                            "url": "https://api.github.com/repos/github/developer.github.com/pages/builds/latest",
                                                                                                            "status": "queued"
                                                                                                          }
                                                                                                          

                                                                                                          List Pages builds

                                                                                                          GET /repos/:owner/:repo/pages/builds
                                                                                                          
                                                                                                          Status: 200 OK
                                                                                                          Link: <https://api.github.com/resource?page=2>; rel="next",
                                                                                                                <https://api.github.com/resource?page=5>; rel="last"
                                                                                                          
                                                                                                          [
                                                                                                            {
                                                                                                              "url": "https://api.github.com/repos/github/developer.github.com/pages/builds/5472601",
                                                                                                              "status": "built",
                                                                                                              "error": {
                                                                                                                "message": null
                                                                                                              },
                                                                                                              "pusher": {
                                                                                                                "login": "octocat",
                                                                                                                "id": 1,
                                                                                                                "avatar_url": "https://github.com/images/error/octocat_happy.gif",
                                                                                                                "gravatar_id": "",
                                                                                                                "url": "https://api.github.com/users/octocat",
                                                                                                                "html_url": "https://github.com/octocat",
                                                                                                                "followers_url": "https://api.github.com/users/octocat/followers",
                                                                                                                "following_url": "https://api.github.com/users/octocat/following{/other_user}",
                                                                                                                "gists_url": "https://api.github.com/users/octocat/gists{/gist_id}",
                                                                                                                "starred_url": "https://api.github.com/users/octocat/starred{/owner}{/repo}",
                                                                                                                "subscriptions_url": "https://api.github.com/users/octocat/subscriptions",
                                                                                                                "organizations_url": "https://api.github.com/users/octocat/orgs",
                                                                                                                "repos_url": "https://api.github.com/users/octocat/repos",
                                                                                                                "events_url": "https://api.github.com/users/octocat/events{/privacy}",
                                                                                                                "received_events_url": "https://api.github.com/users/octocat/received_events",
                                                                                                                "type": "User",
                                                                                                                "site_admin": false
                                                                                                              },
                                                                                                              "commit": "351391cdcb88ffae71ec3028c91f375a8036a26b",
                                                                                                              "duration": 2104,
                                                                                                              "created_at": "2014-02-10T19:00:49Z",
                                                                                                              "updated_at": "2014-02-10T19:00:51Z"
                                                                                                            }
                                                                                                          ]
                                                                                                          

                                                                                                          List latest Pages build

                                                                                                          GET /repos/:owner/:repo/pages/builds/latest
                                                                                                          
                                                                                                          Status: 200 OK
                                                                                                          
                                                                                                          {
                                                                                                            "url": "https://api.github.com/repos/github/developer.github.com/pages/builds/5472601",
                                                                                                            "status": "built",
                                                                                                            "error": {
                                                                                                              "message": null
                                                                                                            },
                                                                                                            "pusher": {
                                                                                                              "login": "octocat",
                                                                                                              "id": 1,
                                                                                                              "avatar_url": "https://github.com/images/error/octocat_happy.gif",
                                                                                                              "gravatar_id": "",
                                                                                                              "url": "https://api.github.com/users/octocat",
                                                                                                              "html_url": "https://github.com/octocat",
                                                                                                              "followers_url": "https://api.github.com/users/octocat/followers",
                                                                                                              "following_url": "https://api.github.com/users/octocat/following{/other_user}",
                                                                                                              "gists_url": "https://api.github.com/users/octocat/gists{/gist_id}",
                                                                                                              "starred_url": "https://api.github.com/users/octocat/starred{/owner}{/repo}",
                                                                                                              "subscriptions_url": "https://api.github.com/users/octocat/subscriptions",
                                                                                                              "organizations_url": "https://api.github.com/users/octocat/orgs",
                                                                                                              "repos_url": "https://api.github.com/users/octocat/repos",
                                                                                                              "events_url": "https://api.github.com/users/octocat/events{/privacy}",
                                                                                                              "received_events_url": "https://api.github.com/users/octocat/received_events",
                                                                                                              "type": "User",
                                                                                                              "site_admin": false
                                                                                                            },
                                                                                                            "commit": "351391cdcb88ffae71ec3028c91f375a8036a26b",
                                                                                                            "duration": 2104,
                                                                                                            "created_at": "2014-02-10T19:00:49Z",
                                                                                                            "updated_at": "2014-02-10T19:00:51Z"
                                                                                                          }
                                                                                                          

                                                                                                          List a specific Pages build

                                                                                                          GET /repos/:owner/:repo/pages/builds/:id
                                                                                                          
                                                                                                          Status: 200 OK
                                                                                                          
                                                                                                          {
                                                                                                            "url": "https://api.github.com/repos/github/developer.github.com/pages/builds/5472601",
                                                                                                            "status": "built",
                                                                                                            "error": {
                                                                                                              "message": null
                                                                                                            },
                                                                                                            "pusher": {
                                                                                                              "login": "octocat",
                                                                                                              "id": 1,
                                                                                                              "avatar_url": "https://github.com/images/error/octocat_happy.gif",
                                                                                                              "gravatar_id": "",
                                                                                                              "url": "https://api.github.com/users/octocat",
                                                                                                              "html_url": "https://github.com/octocat",
                                                                                                              "followers_url": "https://api.github.com/users/octocat/followers",
                                                                                                              "following_url": "https://api.github.com/users/octocat/following{/other_user}",
                                                                                                              "gists_url": "https://api.github.com/users/octocat/gists{/gist_id}",
                                                                                                              "starred_url": "https://api.github.com/users/octocat/starred{/owner}{/repo}",
                                                                                                              "subscriptions_url": "https://api.github.com/users/octocat/subscriptions",
                                                                                                              "organizations_url": "https://api.github.com/users/octocat/orgs",
                                                                                                              "repos_url": "https://api.github.com/users/octocat/repos",
                                                                                                              "events_url": "https://api.github.com/users/octocat/events{/privacy}",
                                                                                                              "received_events_url": "https://api.github.com/users/octocat/received_events",
                                                                                                              "type": "User",
                                                                                                              "site_admin": false
                                                                                                            },
                                                                                                            "commit": "351391cdcb88ffae71ec3028c91f375a8036a26b",
                                                                                                            "duration": 2104,
                                                                                                            "created_at": "2014-02-10T19:00:49Z",
                                                                                                            "updated_at": "2014-02-10T19:00:51Z"
                                                                                                          }
                                                                                                          
                                                                                                          tmp/developer.github.com/v3/repos/pre_receive_hooks/index.html Repository Pre-receive Hooks | GitHub Developer Guide

                                                                                                          Repository Pre-receive Hooks (Enterprise)

                                                                                                          APIs for managing pre-receive hooks are currently available for developers to preview. During the preview period, the APIs may change without advance notice.

                                                                                                          To access the API you must provide a custom media type in the Accept header:

                                                                                                            application/vnd.github.eye-scream-preview
                                                                                                          

                                                                                                          The Repository Pre-receive Hooks API allows you to view and modify enforcement of the pre-receive hooks that are available to a repository.

                                                                                                          Prefix all the endpoints for this API with the following URL:

                                                                                                          http(s)://hostname/api/v3
                                                                                                          

                                                                                                          Object attributes

                                                                                                          Name Type Description
                                                                                                          name string The name of the hook.
                                                                                                          enforcement string The state of enforcement for the hook on this repository.
                                                                                                          configuration_url string URL for the endpoint where enforcement is set.

                                                                                                          Possible values for enforcement are enabled, disabled andtesting. disabled indicates the pre-receive hook will not run. enabled indicates it will run and reject any pushes that result in a non-zero status. testing means the script will run but will not cause any pushes to be rejected.

                                                                                                          configuration_url may be a link to this repository, it's organization owner or global configuration. Authorization to access the endpoint at configuration_url is determined at the owner or site admin level.

                                                                                                          List pre-receive hooks

                                                                                                          List all pre-receive hooks that are enabled or testing for this repository as well as any disabled hooks that are allowed to be enabled at the repository level. Pre-receive hooks that are disabled at a higher level and are not configurable will not be listed.

                                                                                                          GET /repos/:owner/:repo/pre-receive-hooks
                                                                                                          
                                                                                                          Status: 200 OK
                                                                                                          Link: <https://api.github.com/resource?page=2>; rel="next",
                                                                                                                <https://api.github.com/resource?page=5>; rel="last"
                                                                                                          
                                                                                                          [
                                                                                                            {
                                                                                                              "id": 42,
                                                                                                              "name": "Check Commits",
                                                                                                              "enforcement": "disabled",
                                                                                                              "configuration_url": "https://github.example.com/api/v3/orgs/octocat/pre-receive-hooks/42"
                                                                                                            }
                                                                                                          ]
                                                                                                          

                                                                                                          Get a single pre-receive hook

                                                                                                          GET /repos/:owner/:repo/pre-receive-hooks/:id
                                                                                                          
                                                                                                          Status: 200 OK
                                                                                                          
                                                                                                          {
                                                                                                            "id": 42,
                                                                                                            "name": "Check Commits",
                                                                                                            "enforcement": "disabled",
                                                                                                            "configuration_url": "https://github.example.com/api/v3/orgs/octocat/pre-receive-hooks/42"
                                                                                                          }
                                                                                                          

                                                                                                          Update pre-receive hook enforcement

                                                                                                          For pre-receive hooks which are allowed to be configured at the repo level, you can set enforcement

                                                                                                          PATCH /repos/:owner/:repo/pre-receive-hooks/:id
                                                                                                          
                                                                                                          {
                                                                                                            "enforcement": "enabled"
                                                                                                          }
                                                                                                          

                                                                                                          Response

                                                                                                          Status: 200 OK
                                                                                                          
                                                                                                          {
                                                                                                            "id": 42,
                                                                                                            "name": "Check Commits",
                                                                                                            "enforcement": "enabled",
                                                                                                            "configuration_url": "https://github.example.com/api/v3/repos/octocat/hello-world/pre-receive-hooks/42"
                                                                                                          }
                                                                                                          

                                                                                                          Remove enforcement overrides for a pre-receive hook

                                                                                                          Deletes any overridden enforcement on this repository for the specified hook.

                                                                                                          DELETE /repos/:owner/:repo/pre-receive-hooks/:id
                                                                                                          

                                                                                                          Response

                                                                                                          Responds with effective values inherited from owner and/or global level.

                                                                                                          Status: 200 OK
                                                                                                          
                                                                                                          {
                                                                                                            "id": 42,
                                                                                                            "name": "Check Commits",
                                                                                                            "enforcement": "disabled",
                                                                                                            "configuration_url": "https://github.example.com/api/v3/orgs/octocat/pre-receive-hooks/42"
                                                                                                          }
                                                                                                          
                                                                                                          tmp/developer.github.com/v3/repos/releases/index.html Releases | GitHub Developer Guide

                                                                                                          Releases

                                                                                                          Note: To help with migrating from our REST API v3 to GraphQL API v4, we're introducing a preview period to include the GraphQL node_id in the response for many REST API v3 resources. See the blog post for full details. To access node_id during the preview period, you must provide a custom media type in the Accept header:

                                                                                                          application/vnd.github.jean-grey-preview+json
                                                                                                          

                                                                                                          Warning: The API may change without advance notice during the preview period. Preview features are not supported for production use. If you experience any issues, contact GitHub support.

                                                                                                          List releases for a repository

                                                                                                          This returns a list of releases, which does not include regular Git tags that have not been associated with a release. To get a list of Git tags, use the Repository Tags API.

                                                                                                          Information about published releases are available to everyone. Only users with push access will receive listings for draft releases.

                                                                                                          GET /repos/:owner/:repo/releases
                                                                                                          

                                                                                                          Response

                                                                                                          Status: 200 OK
                                                                                                          Link: <https://api.github.com/resource?page=2>; rel="next",
                                                                                                                <https://api.github.com/resource?page=5>; rel="last"
                                                                                                          
                                                                                                          [
                                                                                                            {
                                                                                                              "url": "https://api.github.com/repos/octocat/Hello-World/releases/1",
                                                                                                              "html_url": "https://github.com/octocat/Hello-World/releases/v1.0.0",
                                                                                                              "assets_url": "https://api.github.com/repos/octocat/Hello-World/releases/1/assets",
                                                                                                              "upload_url": "https://uploads.github.com/repos/octocat/Hello-World/releases/1/assets{?name,label}",
                                                                                                              "tarball_url": "https://api.github.com/repos/octocat/Hello-World/tarball/v1.0.0",
                                                                                                              "zipball_url": "https://api.github.com/repos/octocat/Hello-World/zipball/v1.0.0",
                                                                                                              "id": 1,
                                                                                                              "tag_name": "v1.0.0",
                                                                                                              "target_commitish": "master",
                                                                                                              "name": "v1.0.0",
                                                                                                              "body": "Description of the release",
                                                                                                              "draft": false,
                                                                                                              "prerelease": false,
                                                                                                              "created_at": "2013-02-27T19:35:32Z",
                                                                                                              "published_at": "2013-02-27T19:35:32Z",
                                                                                                              "author": {
                                                                                                                "login": "octocat",
                                                                                                                "id": 1,
                                                                                                                "avatar_url": "https://github.com/images/error/octocat_happy.gif",
                                                                                                                "gravatar_id": "",
                                                                                                                "url": "https://api.github.com/users/octocat",
                                                                                                                "html_url": "https://github.com/octocat",
                                                                                                                "followers_url": "https://api.github.com/users/octocat/followers",
                                                                                                                "following_url": "https://api.github.com/users/octocat/following{/other_user}",
                                                                                                                "gists_url": "https://api.github.com/users/octocat/gists{/gist_id}",
                                                                                                                "starred_url": "https://api.github.com/users/octocat/starred{/owner}{/repo}",
                                                                                                                "subscriptions_url": "https://api.github.com/users/octocat/subscriptions",
                                                                                                                "organizations_url": "https://api.github.com/users/octocat/orgs",
                                                                                                                "repos_url": "https://api.github.com/users/octocat/repos",
                                                                                                                "events_url": "https://api.github.com/users/octocat/events{/privacy}",
                                                                                                                "received_events_url": "https://api.github.com/users/octocat/received_events",
                                                                                                                "type": "User",
                                                                                                                "site_admin": false
                                                                                                              },
                                                                                                              "assets": [
                                                                                                                {
                                                                                                                  "url": "https://api.github.com/repos/octocat/Hello-World/releases/assets/1",
                                                                                                                  "browser_download_url": "https://github.com/octocat/Hello-World/releases/download/v1.0.0/example.zip",
                                                                                                                  "id": 1,
                                                                                                                  "name": "example.zip",
                                                                                                                  "label": "short description",
                                                                                                                  "state": "uploaded",
                                                                                                                  "content_type": "application/zip",
                                                                                                                  "size": 1024,
                                                                                                                  "download_count": 42,
                                                                                                                  "created_at": "2013-02-27T19:35:32Z",
                                                                                                                  "updated_at": "2013-02-27T19:35:32Z",
                                                                                                                  "uploader": {
                                                                                                                    "login": "octocat",
                                                                                                                    "id": 1,
                                                                                                                    "avatar_url": "https://github.com/images/error/octocat_happy.gif",
                                                                                                                    "gravatar_id": "",
                                                                                                                    "url": "https://api.github.com/users/octocat",
                                                                                                                    "html_url": "https://github.com/octocat",
                                                                                                                    "followers_url": "https://api.github.com/users/octocat/followers",
                                                                                                                    "following_url": "https://api.github.com/users/octocat/following{/other_user}",
                                                                                                                    "gists_url": "https://api.github.com/users/octocat/gists{/gist_id}",
                                                                                                                    "starred_url": "https://api.github.com/users/octocat/starred{/owner}{/repo}",
                                                                                                                    "subscriptions_url": "https://api.github.com/users/octocat/subscriptions",
                                                                                                                    "organizations_url": "https://api.github.com/users/octocat/orgs",
                                                                                                                    "repos_url": "https://api.github.com/users/octocat/repos",
                                                                                                                    "events_url": "https://api.github.com/users/octocat/events{/privacy}",
                                                                                                                    "received_events_url": "https://api.github.com/users/octocat/received_events",
                                                                                                                    "type": "User",
                                                                                                                    "site_admin": false
                                                                                                                  }
                                                                                                                }
                                                                                                              ]
                                                                                                            }
                                                                                                          ]
                                                                                                          

                                                                                                          Get a single release

                                                                                                          GET /repos/:owner/:repo/releases/:id
                                                                                                          

                                                                                                          Response

                                                                                                          Note: This returns an upload_url key corresponding to the endpoint for uploading release assets. This key is a hypermedia resource.

                                                                                                          Status: 200 OK
                                                                                                          
                                                                                                          {
                                                                                                            "url": "https://api.github.com/repos/octocat/Hello-World/releases/1",
                                                                                                            "html_url": "https://github.com/octocat/Hello-World/releases/v1.0.0",
                                                                                                            "assets_url": "https://api.github.com/repos/octocat/Hello-World/releases/1/assets",
                                                                                                            "upload_url": "https://uploads.github.com/repos/octocat/Hello-World/releases/1/assets{?name,label}",
                                                                                                            "tarball_url": "https://api.github.com/repos/octocat/Hello-World/tarball/v1.0.0",
                                                                                                            "zipball_url": "https://api.github.com/repos/octocat/Hello-World/zipball/v1.0.0",
                                                                                                            "id": 1,
                                                                                                            "tag_name": "v1.0.0",
                                                                                                            "target_commitish": "master",
                                                                                                            "name": "v1.0.0",
                                                                                                            "body": "Description of the release",
                                                                                                            "draft": false,
                                                                                                            "prerelease": false,
                                                                                                            "created_at": "2013-02-27T19:35:32Z",
                                                                                                            "published_at": "2013-02-27T19:35:32Z",
                                                                                                            "author": {
                                                                                                              "login": "octocat",
                                                                                                              "id": 1,
                                                                                                              "avatar_url": "https://github.com/images/error/octocat_happy.gif",
                                                                                                              "gravatar_id": "",
                                                                                                              "url": "https://api.github.com/users/octocat",
                                                                                                              "html_url": "https://github.com/octocat",
                                                                                                              "followers_url": "https://api.github.com/users/octocat/followers",
                                                                                                              "following_url": "https://api.github.com/users/octocat/following{/other_user}",
                                                                                                              "gists_url": "https://api.github.com/users/octocat/gists{/gist_id}",
                                                                                                              "starred_url": "https://api.github.com/users/octocat/starred{/owner}{/repo}",
                                                                                                              "subscriptions_url": "https://api.github.com/users/octocat/subscriptions",
                                                                                                              "organizations_url": "https://api.github.com/users/octocat/orgs",
                                                                                                              "repos_url": "https://api.github.com/users/octocat/repos",
                                                                                                              "events_url": "https://api.github.com/users/octocat/events{/privacy}",
                                                                                                              "received_events_url": "https://api.github.com/users/octocat/received_events",
                                                                                                              "type": "User",
                                                                                                              "site_admin": false
                                                                                                            },
                                                                                                            "assets": [
                                                                                                              {
                                                                                                                "url": "https://api.github.com/repos/octocat/Hello-World/releases/assets/1",
                                                                                                                "browser_download_url": "https://github.com/octocat/Hello-World/releases/download/v1.0.0/example.zip",
                                                                                                                "id": 1,
                                                                                                                "name": "example.zip",
                                                                                                                "label": "short description",
                                                                                                                "state": "uploaded",
                                                                                                                "content_type": "application/zip",
                                                                                                                "size": 1024,
                                                                                                                "download_count": 42,
                                                                                                                "created_at": "2013-02-27T19:35:32Z",
                                                                                                                "updated_at": "2013-02-27T19:35:32Z",
                                                                                                                "uploader": {
                                                                                                                  "login": "octocat",
                                                                                                                  "id": 1,
                                                                                                                  "avatar_url": "https://github.com/images/error/octocat_happy.gif",
                                                                                                                  "gravatar_id": "",
                                                                                                                  "url": "https://api.github.com/users/octocat",
                                                                                                                  "html_url": "https://github.com/octocat",
                                                                                                                  "followers_url": "https://api.github.com/users/octocat/followers",
                                                                                                                  "following_url": "https://api.github.com/users/octocat/following{/other_user}",
                                                                                                                  "gists_url": "https://api.github.com/users/octocat/gists{/gist_id}",
                                                                                                                  "starred_url": "https://api.github.com/users/octocat/starred{/owner}{/repo}",
                                                                                                                  "subscriptions_url": "https://api.github.com/users/octocat/subscriptions",
                                                                                                                  "organizations_url": "https://api.github.com/users/octocat/orgs",
                                                                                                                  "repos_url": "https://api.github.com/users/octocat/repos",
                                                                                                                  "events_url": "https://api.github.com/users/octocat/events{/privacy}",
                                                                                                                  "received_events_url": "https://api.github.com/users/octocat/received_events",
                                                                                                                  "type": "User",
                                                                                                                  "site_admin": false
                                                                                                                }
                                                                                                              }
                                                                                                            ]
                                                                                                          }
                                                                                                          

                                                                                                          Get the latest release

                                                                                                          View the latest published full release for the repository. Draft releases and prereleases are not returned by this endpoint.

                                                                                                          GET /repos/:owner/:repo/releases/latest
                                                                                                          

                                                                                                          Response

                                                                                                          Status: 200 OK
                                                                                                          
                                                                                                          {
                                                                                                            "url": "https://api.github.com/repos/octocat/Hello-World/releases/1",
                                                                                                            "html_url": "https://github.com/octocat/Hello-World/releases/v1.0.0",
                                                                                                            "assets_url": "https://api.github.com/repos/octocat/Hello-World/releases/1/assets",
                                                                                                            "upload_url": "https://uploads.github.com/repos/octocat/Hello-World/releases/1/assets{?name,label}",
                                                                                                            "tarball_url": "https://api.github.com/repos/octocat/Hello-World/tarball/v1.0.0",
                                                                                                            "zipball_url": "https://api.github.com/repos/octocat/Hello-World/zipball/v1.0.0",
                                                                                                            "id": 1,
                                                                                                            "tag_name": "v1.0.0",
                                                                                                            "target_commitish": "master",
                                                                                                            "name": "v1.0.0",
                                                                                                            "body": "Description of the release",
                                                                                                            "draft": false,
                                                                                                            "prerelease": false,
                                                                                                            "created_at": "2013-02-27T19:35:32Z",
                                                                                                            "published_at": "2013-02-27T19:35:32Z",
                                                                                                            "author": {
                                                                                                              "login": "octocat",
                                                                                                              "id": 1,
                                                                                                              "avatar_url": "https://github.com/images/error/octocat_happy.gif",
                                                                                                              "gravatar_id": "",
                                                                                                              "url": "https://api.github.com/users/octocat",
                                                                                                              "html_url": "https://github.com/octocat",
                                                                                                              "followers_url": "https://api.github.com/users/octocat/followers",
                                                                                                              "following_url": "https://api.github.com/users/octocat/following{/other_user}",
                                                                                                              "gists_url": "https://api.github.com/users/octocat/gists{/gist_id}",
                                                                                                              "starred_url": "https://api.github.com/users/octocat/starred{/owner}{/repo}",
                                                                                                              "subscriptions_url": "https://api.github.com/users/octocat/subscriptions",
                                                                                                              "organizations_url": "https://api.github.com/users/octocat/orgs",
                                                                                                              "repos_url": "https://api.github.com/users/octocat/repos",
                                                                                                              "events_url": "https://api.github.com/users/octocat/events{/privacy}",
                                                                                                              "received_events_url": "https://api.github.com/users/octocat/received_events",
                                                                                                              "type": "User",
                                                                                                              "site_admin": false
                                                                                                            },
                                                                                                            "assets": [
                                                                                                              {
                                                                                                                "url": "https://api.github.com/repos/octocat/Hello-World/releases/assets/1",
                                                                                                                "browser_download_url": "https://github.com/octocat/Hello-World/releases/download/v1.0.0/example.zip",
                                                                                                                "id": 1,
                                                                                                                "name": "example.zip",
                                                                                                                "label": "short description",
                                                                                                                "state": "uploaded",
                                                                                                                "content_type": "application/zip",
                                                                                                                "size": 1024,
                                                                                                                "download_count": 42,
                                                                                                                "created_at": "2013-02-27T19:35:32Z",
                                                                                                                "updated_at": "2013-02-27T19:35:32Z",
                                                                                                                "uploader": {
                                                                                                                  "login": "octocat",
                                                                                                                  "id": 1,
                                                                                                                  "avatar_url": "https://github.com/images/error/octocat_happy.gif",
                                                                                                                  "gravatar_id": "",
                                                                                                                  "url": "https://api.github.com/users/octocat",
                                                                                                                  "html_url": "https://github.com/octocat",
                                                                                                                  "followers_url": "https://api.github.com/users/octocat/followers",
                                                                                                                  "following_url": "https://api.github.com/users/octocat/following{/other_user}",
                                                                                                                  "gists_url": "https://api.github.com/users/octocat/gists{/gist_id}",
                                                                                                                  "starred_url": "https://api.github.com/users/octocat/starred{/owner}{/repo}",
                                                                                                                  "subscriptions_url": "https://api.github.com/users/octocat/subscriptions",
                                                                                                                  "organizations_url": "https://api.github.com/users/octocat/orgs",
                                                                                                                  "repos_url": "https://api.github.com/users/octocat/repos",
                                                                                                                  "events_url": "https://api.github.com/users/octocat/events{/privacy}",
                                                                                                                  "received_events_url": "https://api.github.com/users/octocat/received_events",
                                                                                                                  "type": "User",
                                                                                                                  "site_admin": false
                                                                                                                }
                                                                                                              }
                                                                                                            ]
                                                                                                          }
                                                                                                          

                                                                                                          Get a release by tag name

                                                                                                          Get a published release with the specified tag.

                                                                                                          GET /repos/:owner/:repo/releases/tags/:tag
                                                                                                          

                                                                                                          Response

                                                                                                          Status: 200 OK
                                                                                                          
                                                                                                          {
                                                                                                            "url": "https://api.github.com/repos/octocat/Hello-World/releases/1",
                                                                                                            "html_url": "https://github.com/octocat/Hello-World/releases/v1.0.0",
                                                                                                            "assets_url": "https://api.github.com/repos/octocat/Hello-World/releases/1/assets",
                                                                                                            "upload_url": "https://uploads.github.com/repos/octocat/Hello-World/releases/1/assets{?name,label}",
                                                                                                            "tarball_url": "https://api.github.com/repos/octocat/Hello-World/tarball/v1.0.0",
                                                                                                            "zipball_url": "https://api.github.com/repos/octocat/Hello-World/zipball/v1.0.0",
                                                                                                            "id": 1,
                                                                                                            "tag_name": "v1.0.0",
                                                                                                            "target_commitish": "master",
                                                                                                            "name": "v1.0.0",
                                                                                                            "body": "Description of the release",
                                                                                                            "draft": false,
                                                                                                            "prerelease": false,
                                                                                                            "created_at": "2013-02-27T19:35:32Z",
                                                                                                            "published_at": "2013-02-27T19:35:32Z",
                                                                                                            "author": {
                                                                                                              "login": "octocat",
                                                                                                              "id": 1,
                                                                                                              "avatar_url": "https://github.com/images/error/octocat_happy.gif",
                                                                                                              "gravatar_id": "",
                                                                                                              "url": "https://api.github.com/users/octocat",
                                                                                                              "html_url": "https://github.com/octocat",
                                                                                                              "followers_url": "https://api.github.com/users/octocat/followers",
                                                                                                              "following_url": "https://api.github.com/users/octocat/following{/other_user}",
                                                                                                              "gists_url": "https://api.github.com/users/octocat/gists{/gist_id}",
                                                                                                              "starred_url": "https://api.github.com/users/octocat/starred{/owner}{/repo}",
                                                                                                              "subscriptions_url": "https://api.github.com/users/octocat/subscriptions",
                                                                                                              "organizations_url": "https://api.github.com/users/octocat/orgs",
                                                                                                              "repos_url": "https://api.github.com/users/octocat/repos",
                                                                                                              "events_url": "https://api.github.com/users/octocat/events{/privacy}",
                                                                                                              "received_events_url": "https://api.github.com/users/octocat/received_events",
                                                                                                              "type": "User",
                                                                                                              "site_admin": false
                                                                                                            },
                                                                                                            "assets": [
                                                                                                              {
                                                                                                                "url": "https://api.github.com/repos/octocat/Hello-World/releases/assets/1",
                                                                                                                "browser_download_url": "https://github.com/octocat/Hello-World/releases/download/v1.0.0/example.zip",
                                                                                                                "id": 1,
                                                                                                                "name": "example.zip",
                                                                                                                "label": "short description",
                                                                                                                "state": "uploaded",
                                                                                                                "content_type": "application/zip",
                                                                                                                "size": 1024,
                                                                                                                "download_count": 42,
                                                                                                                "created_at": "2013-02-27T19:35:32Z",
                                                                                                                "updated_at": "2013-02-27T19:35:32Z",
                                                                                                                "uploader": {
                                                                                                                  "login": "octocat",
                                                                                                                  "id": 1,
                                                                                                                  "avatar_url": "https://github.com/images/error/octocat_happy.gif",
                                                                                                                  "gravatar_id": "",
                                                                                                                  "url": "https://api.github.com/users/octocat",
                                                                                                                  "html_url": "https://github.com/octocat",
                                                                                                                  "followers_url": "https://api.github.com/users/octocat/followers",
                                                                                                                  "following_url": "https://api.github.com/users/octocat/following{/other_user}",
                                                                                                                  "gists_url": "https://api.github.com/users/octocat/gists{/gist_id}",
                                                                                                                  "starred_url": "https://api.github.com/users/octocat/starred{/owner}{/repo}",
                                                                                                                  "subscriptions_url": "https://api.github.com/users/octocat/subscriptions",
                                                                                                                  "organizations_url": "https://api.github.com/users/octocat/orgs",
                                                                                                                  "repos_url": "https://api.github.com/users/octocat/repos",
                                                                                                                  "events_url": "https://api.github.com/users/octocat/events{/privacy}",
                                                                                                                  "received_events_url": "https://api.github.com/users/octocat/received_events",
                                                                                                                  "type": "User",
                                                                                                                  "site_admin": false
                                                                                                                }
                                                                                                              }
                                                                                                            ]
                                                                                                          }
                                                                                                          

                                                                                                          Create a release

                                                                                                          Users with push access to the repository can create a release.

                                                                                                          POST /repos/:owner/:repo/releases
                                                                                                          

                                                                                                          Input

                                                                                                          Name Type Description
                                                                                                          tag_name string Required. The name of the tag.
                                                                                                          target_commitish string Specifies the commitish value that determines where the Git tag is created from. Can be any branch or commit SHA. Unused if the Git tag already exists. Default: the repository's default branch (usually master).
                                                                                                          name string The name of the release.
                                                                                                          body string Text describing the contents of the tag.
                                                                                                          draft boolean true to create a draft (unpublished) release, false to create a published one. Default: false
                                                                                                          prerelease boolean true to identify the release as a prerelease. false to identify the release as a full release. Default: false

                                                                                                          Example

                                                                                                          {
                                                                                                            "tag_name": "v1.0.0",
                                                                                                            "target_commitish": "master",
                                                                                                            "name": "v1.0.0",
                                                                                                            "body": "Description of the release",
                                                                                                            "draft": false,
                                                                                                            "prerelease": false
                                                                                                          }
                                                                                                          

                                                                                                          Response

                                                                                                          Status: 201 Created
                                                                                                          Location: https://api.github.com/repos/octocat/Hello-World/releases/1
                                                                                                          
                                                                                                          {
                                                                                                            "url": "https://api.github.com/repos/octocat/Hello-World/releases/1",
                                                                                                            "html_url": "https://github.com/octocat/Hello-World/releases/v1.0.0",
                                                                                                            "assets_url": "https://api.github.com/repos/octocat/Hello-World/releases/1/assets",
                                                                                                            "upload_url": "https://uploads.github.com/repos/octocat/Hello-World/releases/1/assets{?name,label}",
                                                                                                            "tarball_url": "https://api.github.com/repos/octocat/Hello-World/tarball/v1.0.0",
                                                                                                            "zipball_url": "https://api.github.com/repos/octocat/Hello-World/zipball/v1.0.0",
                                                                                                            "id": 1,
                                                                                                            "tag_name": "v1.0.0",
                                                                                                            "target_commitish": "master",
                                                                                                            "name": "v1.0.0",
                                                                                                            "body": "Description of the release",
                                                                                                            "draft": false,
                                                                                                            "prerelease": false,
                                                                                                            "created_at": "2013-02-27T19:35:32Z",
                                                                                                            "published_at": "2013-02-27T19:35:32Z",
                                                                                                            "author": {
                                                                                                              "login": "octocat",
                                                                                                              "id": 1,
                                                                                                              "avatar_url": "https://github.com/images/error/octocat_happy.gif",
                                                                                                              "gravatar_id": "",
                                                                                                              "url": "https://api.github.com/users/octocat",
                                                                                                              "html_url": "https://github.com/octocat",
                                                                                                              "followers_url": "https://api.github.com/users/octocat/followers",
                                                                                                              "following_url": "https://api.github.com/users/octocat/following{/other_user}",
                                                                                                              "gists_url": "https://api.github.com/users/octocat/gists{/gist_id}",
                                                                                                              "starred_url": "https://api.github.com/users/octocat/starred{/owner}{/repo}",
                                                                                                              "subscriptions_url": "https://api.github.com/users/octocat/subscriptions",
                                                                                                              "organizations_url": "https://api.github.com/users/octocat/orgs",
                                                                                                              "repos_url": "https://api.github.com/users/octocat/repos",
                                                                                                              "events_url": "https://api.github.com/users/octocat/events{/privacy}",
                                                                                                              "received_events_url": "https://api.github.com/users/octocat/received_events",
                                                                                                              "type": "User",
                                                                                                              "site_admin": false
                                                                                                            },
                                                                                                            "assets": [
                                                                                                          
                                                                                                            ]
                                                                                                          }
                                                                                                          

                                                                                                          Edit a release

                                                                                                          Users with push access to the repository can edit a release.

                                                                                                          PATCH /repos/:owner/:repo/releases/:id
                                                                                                          

                                                                                                          Input

                                                                                                          Name Type Description
                                                                                                          tag_name string The name of the tag.
                                                                                                          target_commitish string Specifies the commitish value that determines where the Git tag is created from. Can be any branch or commit SHA. Unused if the Git tag already exists. Default: the repository's default branch (usually master).
                                                                                                          name string The name of the release.
                                                                                                          body string Text describing the contents of the tag.
                                                                                                          draft boolean true makes the release a draft, and false publishes the release.
                                                                                                          prerelease boolean true to identify the release as a prerelease, false to identify the release as a full release.

                                                                                                          Example

                                                                                                          {
                                                                                                            "tag_name": "v1.0.0",
                                                                                                            "target_commitish": "master",
                                                                                                            "name": "v1.0.0",
                                                                                                            "body": "Description of the release",
                                                                                                            "draft": false,
                                                                                                            "prerelease": false
                                                                                                          }
                                                                                                          

                                                                                                          Response

                                                                                                          Status: 200 OK
                                                                                                          
                                                                                                          {
                                                                                                            "url": "https://api.github.com/repos/octocat/Hello-World/releases/1",
                                                                                                            "html_url": "https://github.com/octocat/Hello-World/releases/v1.0.0",
                                                                                                            "assets_url": "https://api.github.com/repos/octocat/Hello-World/releases/1/assets",
                                                                                                            "upload_url": "https://uploads.github.com/repos/octocat/Hello-World/releases/1/assets{?name,label}",
                                                                                                            "tarball_url": "https://api.github.com/repos/octocat/Hello-World/tarball/v1.0.0",
                                                                                                            "zipball_url": "https://api.github.com/repos/octocat/Hello-World/zipball/v1.0.0",
                                                                                                            "id": 1,
                                                                                                            "tag_name": "v1.0.0",
                                                                                                            "target_commitish": "master",
                                                                                                            "name": "v1.0.0",
                                                                                                            "body": "Description of the release",
                                                                                                            "draft": false,
                                                                                                            "prerelease": false,
                                                                                                            "created_at": "2013-02-27T19:35:32Z",
                                                                                                            "published_at": "2013-02-27T19:35:32Z",
                                                                                                            "author": {
                                                                                                              "login": "octocat",
                                                                                                              "id": 1,
                                                                                                              "avatar_url": "https://github.com/images/error/octocat_happy.gif",
                                                                                                              "gravatar_id": "",
                                                                                                              "url": "https://api.github.com/users/octocat",
                                                                                                              "html_url": "https://github.com/octocat",
                                                                                                              "followers_url": "https://api.github.com/users/octocat/followers",
                                                                                                              "following_url": "https://api.github.com/users/octocat/following{/other_user}",
                                                                                                              "gists_url": "https://api.github.com/users/octocat/gists{/gist_id}",
                                                                                                              "starred_url": "https://api.github.com/users/octocat/starred{/owner}{/repo}",
                                                                                                              "subscriptions_url": "https://api.github.com/users/octocat/subscriptions",
                                                                                                              "organizations_url": "https://api.github.com/users/octocat/orgs",
                                                                                                              "repos_url": "https://api.github.com/users/octocat/repos",
                                                                                                              "events_url": "https://api.github.com/users/octocat/events{/privacy}",
                                                                                                              "received_events_url": "https://api.github.com/users/octocat/received_events",
                                                                                                              "type": "User",
                                                                                                              "site_admin": false
                                                                                                            },
                                                                                                            "assets": [
                                                                                                              {
                                                                                                                "url": "https://api.github.com/repos/octocat/Hello-World/releases/assets/1",
                                                                                                                "browser_download_url": "https://github.com/octocat/Hello-World/releases/download/v1.0.0/example.zip",
                                                                                                                "id": 1,
                                                                                                                "name": "example.zip",
                                                                                                                "label": "short description",
                                                                                                                "state": "uploaded",
                                                                                                                "content_type": "application/zip",
                                                                                                                "size": 1024,
                                                                                                                "download_count": 42,
                                                                                                                "created_at": "2013-02-27T19:35:32Z",
                                                                                                                "updated_at": "2013-02-27T19:35:32Z",
                                                                                                                "uploader": {
                                                                                                                  "login": "octocat",
                                                                                                                  "id": 1,
                                                                                                                  "avatar_url": "https://github.com/images/error/octocat_happy.gif",
                                                                                                                  "gravatar_id": "",
                                                                                                                  "url": "https://api.github.com/users/octocat",
                                                                                                                  "html_url": "https://github.com/octocat",
                                                                                                                  "followers_url": "https://api.github.com/users/octocat/followers",
                                                                                                                  "following_url": "https://api.github.com/users/octocat/following{/other_user}",
                                                                                                                  "gists_url": "https://api.github.com/users/octocat/gists{/gist_id}",
                                                                                                                  "starred_url": "https://api.github.com/users/octocat/starred{/owner}{/repo}",
                                                                                                                  "subscriptions_url": "https://api.github.com/users/octocat/subscriptions",
                                                                                                                  "organizations_url": "https://api.github.com/users/octocat/orgs",
                                                                                                                  "repos_url": "https://api.github.com/users/octocat/repos",
                                                                                                                  "events_url": "https://api.github.com/users/octocat/events{/privacy}",
                                                                                                                  "received_events_url": "https://api.github.com/users/octocat/received_events",
                                                                                                                  "type": "User",
                                                                                                                  "site_admin": false
                                                                                                                }
                                                                                                              }
                                                                                                            ]
                                                                                                          }
                                                                                                          

                                                                                                          Delete a release

                                                                                                          Users with push access to the repository can delete a release.

                                                                                                          DELETE /repos/:owner/:repo/releases/:id
                                                                                                          

                                                                                                          Response

                                                                                                          Status: 204 No Content
                                                                                                          

                                                                                                          List assets for a release

                                                                                                          GET /repos/:owner/:repo/releases/:id/assets
                                                                                                          

                                                                                                          Response

                                                                                                          Status: 200 OK
                                                                                                          Link: <https://api.github.com/resource?page=2>; rel="next",
                                                                                                                <https://api.github.com/resource?page=5>; rel="last"
                                                                                                          
                                                                                                          [
                                                                                                            {
                                                                                                              "url": "https://api.github.com/repos/octocat/Hello-World/releases/assets/1",
                                                                                                              "browser_download_url": "https://github.com/octocat/Hello-World/releases/download/v1.0.0/example.zip",
                                                                                                              "id": 1,
                                                                                                              "name": "example.zip",
                                                                                                              "label": "short description",
                                                                                                              "state": "uploaded",
                                                                                                              "content_type": "application/zip",
                                                                                                              "size": 1024,
                                                                                                              "download_count": 42,
                                                                                                              "created_at": "2013-02-27T19:35:32Z",
                                                                                                              "updated_at": "2013-02-27T19:35:32Z",
                                                                                                              "uploader": {
                                                                                                                "login": "octocat",
                                                                                                                "id": 1,
                                                                                                                "avatar_url": "https://github.com/images/error/octocat_happy.gif",
                                                                                                                "gravatar_id": "",
                                                                                                                "url": "https://api.github.com/users/octocat",
                                                                                                                "html_url": "https://github.com/octocat",
                                                                                                                "followers_url": "https://api.github.com/users/octocat/followers",
                                                                                                                "following_url": "https://api.github.com/users/octocat/following{/other_user}",
                                                                                                                "gists_url": "https://api.github.com/users/octocat/gists{/gist_id}",
                                                                                                                "starred_url": "https://api.github.com/users/octocat/starred{/owner}{/repo}",
                                                                                                                "subscriptions_url": "https://api.github.com/users/octocat/subscriptions",
                                                                                                                "organizations_url": "https://api.github.com/users/octocat/orgs",
                                                                                                                "repos_url": "https://api.github.com/users/octocat/repos",
                                                                                                                "events_url": "https://api.github.com/users/octocat/events{/privacy}",
                                                                                                                "received_events_url": "https://api.github.com/users/octocat/received_events",
                                                                                                                "type": "User",
                                                                                                                "site_admin": false
                                                                                                              }
                                                                                                            }
                                                                                                          ]
                                                                                                          

                                                                                                          Upload a release asset

                                                                                                          This endpoint makes use of a Hypermedia relation to determine which URL to access. This endpoint is provided by a URI template in the release's API response. You need to use an HTTP client which supports SNI to make calls to this endpoint.

                                                                                                          The asset data is expected in its raw binary form, rather than JSON. Everything else about the endpoint is the same as the rest of the API. For example, you'll still need to pass your authentication to be able to upload an asset.

                                                                                                          POST https://<upload_url>/repos/:owner/:repo/releases/:id/assets?name=foo.zip
                                                                                                          

                                                                                                          Input

                                                                                                          The raw file is uploaded to GitHub. Set the content type appropriately, and the asset's name and label in URI query parameters.

                                                                                                          Name Type Description
                                                                                                          Content-Type string Required. The content type of the asset. This should be set in the Header. Example: "application/zip". For a list of acceptable types, refer this list of media types.
                                                                                                          name string Required. The file name of the asset. This should be set in a URI query parameter.
                                                                                                          label string An alternate short description of the asset. Used in place of the filename. This should be set in a URI query parameter.

                                                                                                          Send the raw binary content of the asset as the request body.

                                                                                                          Response for successful upload

                                                                                                          Status: 201 Created
                                                                                                          
                                                                                                          {
                                                                                                            "url": "https://api.github.com/repos/octocat/Hello-World/releases/assets/1",
                                                                                                            "browser_download_url": "https://github.com/octocat/Hello-World/releases/download/v1.0.0/example.zip",
                                                                                                            "id": 1,
                                                                                                            "name": "example.zip",
                                                                                                            "label": "short description",
                                                                                                            "state": "uploaded",
                                                                                                            "content_type": "application/zip",
                                                                                                            "size": 1024,
                                                                                                            "download_count": 42,
                                                                                                            "created_at": "2013-02-27T19:35:32Z",
                                                                                                            "updated_at": "2013-02-27T19:35:32Z",
                                                                                                            "uploader": {
                                                                                                              "login": "octocat",
                                                                                                              "id": 1,
                                                                                                              "avatar_url": "https://github.com/images/error/octocat_happy.gif",
                                                                                                              "gravatar_id": "",
                                                                                                              "url": "https://api.github.com/users/octocat",
                                                                                                              "html_url": "https://github.com/octocat",
                                                                                                              "followers_url": "https://api.github.com/users/octocat/followers",
                                                                                                              "following_url": "https://api.github.com/users/octocat/following{/other_user}",
                                                                                                              "gists_url": "https://api.github.com/users/octocat/gists{/gist_id}",
                                                                                                              "starred_url": "https://api.github.com/users/octocat/starred{/owner}{/repo}",
                                                                                                              "subscriptions_url": "https://api.github.com/users/octocat/subscriptions",
                                                                                                              "organizations_url": "https://api.github.com/users/octocat/orgs",
                                                                                                              "repos_url": "https://api.github.com/users/octocat/repos",
                                                                                                              "events_url": "https://api.github.com/users/octocat/events{/privacy}",
                                                                                                              "received_events_url": "https://api.github.com/users/octocat/received_events",
                                                                                                              "type": "User",
                                                                                                              "site_admin": false
                                                                                                            }
                                                                                                          }
                                                                                                          

                                                                                                          Response for upstream failure

                                                                                                          This may leave an empty asset with a state of "new". It can be safely deleted.

                                                                                                          Status: 502 Bad Gateway
                                                                                                          

                                                                                                          Get a single release asset

                                                                                                          GET /repos/:owner/:repo/releases/assets/:id
                                                                                                          

                                                                                                          Response

                                                                                                          To download the asset's binary content, set the Accept header of the request to application/octet-stream. The API will either redirect the client to the location, or stream it directly if possible. API clients should handle both a 200 or 302 response.

                                                                                                          Status: 200 OK
                                                                                                          
                                                                                                          {
                                                                                                            "url": "https://api.github.com/repos/octocat/Hello-World/releases/assets/1",
                                                                                                            "browser_download_url": "https://github.com/octocat/Hello-World/releases/download/v1.0.0/example.zip",
                                                                                                            "id": 1,
                                                                                                            "name": "example.zip",
                                                                                                            "label": "short description",
                                                                                                            "state": "uploaded",
                                                                                                            "content_type": "application/zip",
                                                                                                            "size": 1024,
                                                                                                            "download_count": 42,
                                                                                                            "created_at": "2013-02-27T19:35:32Z",
                                                                                                            "updated_at": "2013-02-27T19:35:32Z",
                                                                                                            "uploader": {
                                                                                                              "login": "octocat",
                                                                                                              "id": 1,
                                                                                                              "avatar_url": "https://github.com/images/error/octocat_happy.gif",
                                                                                                              "gravatar_id": "",
                                                                                                              "url": "https://api.github.com/users/octocat",
                                                                                                              "html_url": "https://github.com/octocat",
                                                                                                              "followers_url": "https://api.github.com/users/octocat/followers",
                                                                                                              "following_url": "https://api.github.com/users/octocat/following{/other_user}",
                                                                                                              "gists_url": "https://api.github.com/users/octocat/gists{/gist_id}",
                                                                                                              "starred_url": "https://api.github.com/users/octocat/starred{/owner}{/repo}",
                                                                                                              "subscriptions_url": "https://api.github.com/users/octocat/subscriptions",
                                                                                                              "organizations_url": "https://api.github.com/users/octocat/orgs",
                                                                                                              "repos_url": "https://api.github.com/users/octocat/repos",
                                                                                                              "events_url": "https://api.github.com/users/octocat/events{/privacy}",
                                                                                                              "received_events_url": "https://api.github.com/users/octocat/received_events",
                                                                                                              "type": "User",
                                                                                                              "site_admin": false
                                                                                                            }
                                                                                                          }
                                                                                                          

                                                                                                          Edit a release asset

                                                                                                          Users with push access to the repository can edit a release asset.

                                                                                                          PATCH /repos/:owner/:repo/releases/assets/:id
                                                                                                          

                                                                                                          Input

                                                                                                          Name Type Description
                                                                                                          name string Required. The file name of the asset.
                                                                                                          label string An alternate short description of the asset. Used in place of the filename.

                                                                                                          Example

                                                                                                          {
                                                                                                            "name": "foo-1.0.0-osx.zip",
                                                                                                            "label": "Mac binary"
                                                                                                          }
                                                                                                          

                                                                                                          Response

                                                                                                          Status: 200 OK
                                                                                                          
                                                                                                          {
                                                                                                            "url": "https://api.github.com/repos/octocat/Hello-World/releases/assets/1",
                                                                                                            "browser_download_url": "https://github.com/octocat/Hello-World/releases/download/v1.0.0/example.zip",
                                                                                                            "id": 1,
                                                                                                            "name": "example.zip",
                                                                                                            "label": "short description",
                                                                                                            "state": "uploaded",
                                                                                                            "content_type": "application/zip",
                                                                                                            "size": 1024,
                                                                                                            "download_count": 42,
                                                                                                            "created_at": "2013-02-27T19:35:32Z",
                                                                                                            "updated_at": "2013-02-27T19:35:32Z",
                                                                                                            "uploader": {
                                                                                                              "login": "octocat",
                                                                                                              "id": 1,
                                                                                                              "avatar_url": "https://github.com/images/error/octocat_happy.gif",
                                                                                                              "gravatar_id": "",
                                                                                                              "url": "https://api.github.com/users/octocat",
                                                                                                              "html_url": "https://github.com/octocat",
                                                                                                              "followers_url": "https://api.github.com/users/octocat/followers",
                                                                                                              "following_url": "https://api.github.com/users/octocat/following{/other_user}",
                                                                                                              "gists_url": "https://api.github.com/users/octocat/gists{/gist_id}",
                                                                                                              "starred_url": "https://api.github.com/users/octocat/starred{/owner}{/repo}",
                                                                                                              "subscriptions_url": "https://api.github.com/users/octocat/subscriptions",
                                                                                                              "organizations_url": "https://api.github.com/users/octocat/orgs",
                                                                                                              "repos_url": "https://api.github.com/users/octocat/repos",
                                                                                                              "events_url": "https://api.github.com/users/octocat/events{/privacy}",
                                                                                                              "received_events_url": "https://api.github.com/users/octocat/received_events",
                                                                                                              "type": "User",
                                                                                                              "site_admin": false
                                                                                                            }
                                                                                                          }
                                                                                                          

                                                                                                          Delete a release asset

                                                                                                          DELETE /repos/:owner/:repo/releases/assets/:id
                                                                                                          

                                                                                                          Response

                                                                                                          Status: 204 No Content
                                                                                                          
                                                                                                          tmp/developer.github.com/v3/repos/statistics/index.html Statistics | GitHub Developer Guide

                                                                                                          Statistics

                                                                                                          The Repository Statistics API allows you to fetch the data that GitHub uses for visualizing different types of repository activity.

                                                                                                          A word about caching

                                                                                                          Computing repository statistics is an expensive operation, so we try to return cached data whenever possible. If the data hasn't been cached when you query a repository's statistics, you'll receive a 202 response; a background job is also fired to start compiling these statistics. Give the job a few moments to complete, and then submit the request again. If the job has completed, that request will receive a 200 response with the statistics in the response body.

                                                                                                          Repository statistics are cached by the SHA of the repository's default branch, which is usually master; pushing to the default branch resets the statistics cache.

                                                                                                          Statistics exclude some types of commits

                                                                                                          The statistics exposed by the API match the statistics shown by different repository graphs.

                                                                                                          To summarize:

                                                                                                          • All statistics exclude merge commits.
                                                                                                          • Contributor statistics also exclude empty commits.

                                                                                                          Get contributors list with additions, deletions, and commit counts

                                                                                                          GET /repos/:owner/:repo/stats/contributors
                                                                                                          

                                                                                                          Response

                                                                                                          • total - The Total number of commits authored by the contributor.

                                                                                                          Weekly Hash (weeks array):

                                                                                                          • w - Start of the week, given as a Unix timestamp.
                                                                                                          • a - Number of additions
                                                                                                          • d - Number of deletions
                                                                                                          • c - Number of commits
                                                                                                          Status: 200 OK
                                                                                                          
                                                                                                          [
                                                                                                            {
                                                                                                              "author": {
                                                                                                                "login": "octocat",
                                                                                                                "id": 1,
                                                                                                                "avatar_url": "https://github.com/images/error/octocat_happy.gif",
                                                                                                                "gravatar_id": "",
                                                                                                                "url": "https://api.github.com/users/octocat",
                                                                                                                "html_url": "https://github.com/octocat",
                                                                                                                "followers_url": "https://api.github.com/users/octocat/followers",
                                                                                                                "following_url": "https://api.github.com/users/octocat/following{/other_user}",
                                                                                                                "gists_url": "https://api.github.com/users/octocat/gists{/gist_id}",
                                                                                                                "starred_url": "https://api.github.com/users/octocat/starred{/owner}{/repo}",
                                                                                                                "subscriptions_url": "https://api.github.com/users/octocat/subscriptions",
                                                                                                                "organizations_url": "https://api.github.com/users/octocat/orgs",
                                                                                                                "repos_url": "https://api.github.com/users/octocat/repos",
                                                                                                                "events_url": "https://api.github.com/users/octocat/events{/privacy}",
                                                                                                                "received_events_url": "https://api.github.com/users/octocat/received_events",
                                                                                                                "type": "User",
                                                                                                                "site_admin": false
                                                                                                              },
                                                                                                              "total": 135,
                                                                                                              "weeks": [
                                                                                                                {
                                                                                                                  "w": "1367712000",
                                                                                                                  "a": 6898,
                                                                                                                  "d": 77,
                                                                                                                  "c": 10
                                                                                                                }
                                                                                                              ]
                                                                                                            }
                                                                                                          ]
                                                                                                          

                                                                                                          Get the last year of commit activity data

                                                                                                          Returns the last year of commit activity grouped by week. The days array is a group of commits per day, starting on Sunday.

                                                                                                          GET /repos/:owner/:repo/stats/commit_activity
                                                                                                          

                                                                                                          Response

                                                                                                          Status: 200 OK
                                                                                                          
                                                                                                          [
                                                                                                            {
                                                                                                              "days": [
                                                                                                                0,
                                                                                                                3,
                                                                                                                26,
                                                                                                                20,
                                                                                                                39,
                                                                                                                1,
                                                                                                                0
                                                                                                              ],
                                                                                                              "total": 89,
                                                                                                              "week": 1336280400
                                                                                                            }
                                                                                                          ]
                                                                                                          

                                                                                                          Get the number of additions and deletions per week

                                                                                                          GET /repos/:owner/:repo/stats/code_frequency
                                                                                                          

                                                                                                          Response

                                                                                                          Returns a weekly aggregate of the number of additions and deletions pushed to a repository.

                                                                                                          Status: 200 OK
                                                                                                          
                                                                                                          [
                                                                                                            [
                                                                                                              1302998400,
                                                                                                              1124,
                                                                                                              -435
                                                                                                            ]
                                                                                                          ]
                                                                                                          

                                                                                                          Get the weekly commit count for the repository owner and everyone else

                                                                                                          GET /repos/:owner/:repo/stats/participation
                                                                                                          

                                                                                                          Response

                                                                                                          Returns the total commit counts for the owner and total commit counts in all. all is everyone combined, including the owner in the last 52 weeks. If you'd like to get the commit counts for non-owners, you can subtract owner from all.

                                                                                                          The array order is oldest week (index 0) to most recent week.

                                                                                                          Status: 200 OK
                                                                                                          
                                                                                                          {
                                                                                                            "all": [
                                                                                                              11,
                                                                                                              21,
                                                                                                              15,
                                                                                                              2,
                                                                                                              8,
                                                                                                              1,
                                                                                                              8,
                                                                                                              23,
                                                                                                              17,
                                                                                                              21,
                                                                                                              11,
                                                                                                              10,
                                                                                                              33,
                                                                                                              91,
                                                                                                              38,
                                                                                                              34,
                                                                                                              22,
                                                                                                              23,
                                                                                                              32,
                                                                                                              3,
                                                                                                              43,
                                                                                                              87,
                                                                                                              71,
                                                                                                              18,
                                                                                                              13,
                                                                                                              5,
                                                                                                              13,
                                                                                                              16,
                                                                                                              66,
                                                                                                              27,
                                                                                                              12,
                                                                                                              45,
                                                                                                              110,
                                                                                                              117,
                                                                                                              13,
                                                                                                              8,
                                                                                                              18,
                                                                                                              9,
                                                                                                              19,
                                                                                                              26,
                                                                                                              39,
                                                                                                              12,
                                                                                                              20,
                                                                                                              31,
                                                                                                              46,
                                                                                                              91,
                                                                                                              45,
                                                                                                              10,
                                                                                                              24,
                                                                                                              9,
                                                                                                              29,
                                                                                                              7
                                                                                                            ],
                                                                                                            "owner": [
                                                                                                              3,
                                                                                                              2,
                                                                                                              3,
                                                                                                              0,
                                                                                                              2,
                                                                                                              0,
                                                                                                              5,
                                                                                                              14,
                                                                                                              7,
                                                                                                              9,
                                                                                                              1,
                                                                                                              5,
                                                                                                              0,
                                                                                                              48,
                                                                                                              19,
                                                                                                              2,
                                                                                                              0,
                                                                                                              1,
                                                                                                              10,
                                                                                                              2,
                                                                                                              23,
                                                                                                              40,
                                                                                                              35,
                                                                                                              8,
                                                                                                              8,
                                                                                                              2,
                                                                                                              10,
                                                                                                              6,
                                                                                                              30,
                                                                                                              0,
                                                                                                              2,
                                                                                                              9,
                                                                                                              53,
                                                                                                              104,
                                                                                                              3,
                                                                                                              3,
                                                                                                              10,
                                                                                                              4,
                                                                                                              7,
                                                                                                              11,
                                                                                                              21,
                                                                                                              4,
                                                                                                              4,
                                                                                                              22,
                                                                                                              26,
                                                                                                              63,
                                                                                                              11,
                                                                                                              2,
                                                                                                              14,
                                                                                                              1,
                                                                                                              10,
                                                                                                              3
                                                                                                            ]
                                                                                                          }
                                                                                                          

                                                                                                          Get the number of commits per hour in each day

                                                                                                          GET /repos/:owner/:repo/stats/punch_card
                                                                                                          

                                                                                                          Response

                                                                                                          Each array contains the day number, hour number, and number of commits:

                                                                                                          • 0-6: Sunday - Saturday
                                                                                                          • 0-23: Hour of day
                                                                                                          • Number of commits

                                                                                                          For example, [2, 14, 25] indicates that there were 25 total commits, during the 2:00pm hour on Tuesdays. All times are based on the time zone of individual commits.

                                                                                                          Status: 200 OK
                                                                                                          
                                                                                                          [
                                                                                                            [
                                                                                                              0,
                                                                                                              0,
                                                                                                              5
                                                                                                            ],
                                                                                                            [
                                                                                                              0,
                                                                                                              1,
                                                                                                              43
                                                                                                            ],
                                                                                                            [
                                                                                                              0,
                                                                                                              2,
                                                                                                              21
                                                                                                            ]
                                                                                                          ]
                                                                                                          
                                                                                                          tmp/developer.github.com/v3/repos/statuses/index.html Statuses | GitHub Developer Guide

                                                                                                          Statuses

                                                                                                          The status API allows external services to mark commits with an error, failure, pending, or success state, which is then reflected in pull requests involving those commits.

                                                                                                          Statuses can also include an optional description and target_url, and we highly recommend providing them as they make statuses much more useful in the GitHub UI.

                                                                                                          As an example, one common use is for continuous integration services to mark commits as passing or failing builds using status. The target_url would be the full URL to the build output, and the description would be the high level summary of what happened with the build.

                                                                                                          Statuses can include a context to indicate what service is providing that status. For example, you may have your continuous integration service push statuses with a context of ci, and a security audit tool push statuses with a context of security. You can then use the combined status endpoint to retrieve the whole status for a commit.

                                                                                                          Note that the repo:status OAuth scope grants targeted access to statuses without also granting access to repository code, while the repo scope grants permission to code as well as statuses.

                                                                                                          Note: To help with migrating from our REST API v3 to GraphQL API v4, we're introducing a preview period to include the GraphQL node_id in the response for many REST API v3 resources. See the blog post for full details. To access node_id during the preview period, you must provide a custom media type in the Accept header:

                                                                                                          application/vnd.github.jean-grey-preview+json
                                                                                                          

                                                                                                          Warning: The API may change without advance notice during the preview period. Preview features are not supported for production use. If you experience any issues, contact GitHub support.

                                                                                                          Create a status

                                                                                                          Users with push access can create commit statuses for a given ref:

                                                                                                          POST /repos/:owner/:repo/statuses/:sha
                                                                                                          

                                                                                                          Note: there is a limit of 1000 statuses per sha and context within a repository. Attempts to create more than 1000 statuses will result in a validation error.

                                                                                                          Parameters

                                                                                                          Name Type Description
                                                                                                          state string Required. The state of the status. Can be one of error, failure, pending, or success.
                                                                                                          target_url string The target URL to associate with this status. This URL will be linked from the GitHub UI to allow users to easily see the source of the status.
                                                                                                          For example, if your continuous integration system is posting build status, you would want to provide the deep link for the build output for this specific SHA:
                                                                                                          http://ci.example.com/user/repo/build/sha
                                                                                                          description string A short description of the status.
                                                                                                          context string A string label to differentiate this status from the status of other systems. Default: default

                                                                                                          Example

                                                                                                          {
                                                                                                            "state": "success",
                                                                                                            "target_url": "https://example.com/build/status",
                                                                                                            "description": "The build succeeded!",
                                                                                                            "context": "continuous-integration/jenkins"
                                                                                                          }
                                                                                                          

                                                                                                          Response

                                                                                                          Status: 201 Created
                                                                                                          Location: https://api.github.com/repos/octocat/Hello-World/statuses/6dcb09b5b57875f334f61aebed695e2e4193db5e
                                                                                                          
                                                                                                          {
                                                                                                            "created_at": "2012-07-20T01:19:13Z",
                                                                                                            "updated_at": "2012-07-20T01:19:13Z",
                                                                                                            "state": "success",
                                                                                                            "target_url": "https://ci.example.com/1000/output",
                                                                                                            "description": "Build has completed successfully",
                                                                                                            "id": 1,
                                                                                                            "url": "https://api.github.com/repos/octocat/Hello-World/statuses/6dcb09b5b57875f334f61aebed695e2e4193db5e",
                                                                                                            "context": "continuous-integration/jenkins",
                                                                                                            "creator": {
                                                                                                              "login": "octocat",
                                                                                                              "id": 1,
                                                                                                              "avatar_url": "https://github.com/images/error/octocat_happy.gif",
                                                                                                              "gravatar_id": "",
                                                                                                              "url": "https://api.github.com/users/octocat",
                                                                                                              "html_url": "https://github.com/octocat",
                                                                                                              "followers_url": "https://api.github.com/users/octocat/followers",
                                                                                                              "following_url": "https://api.github.com/users/octocat/following{/other_user}",
                                                                                                              "gists_url": "https://api.github.com/users/octocat/gists{/gist_id}",
                                                                                                              "starred_url": "https://api.github.com/users/octocat/starred{/owner}{/repo}",
                                                                                                              "subscriptions_url": "https://api.github.com/users/octocat/subscriptions",
                                                                                                              "organizations_url": "https://api.github.com/users/octocat/orgs",
                                                                                                              "repos_url": "https://api.github.com/users/octocat/repos",
                                                                                                              "events_url": "https://api.github.com/users/octocat/events{/privacy}",
                                                                                                              "received_events_url": "https://api.github.com/users/octocat/received_events",
                                                                                                              "type": "User",
                                                                                                              "site_admin": false
                                                                                                            }
                                                                                                          }
                                                                                                          

                                                                                                          List statuses for a specific ref

                                                                                                          Users with pull access can view commit statuses for a given ref:

                                                                                                          GET /repos/:owner/:repo/commits/:ref/statuses
                                                                                                          

                                                                                                          This resource is also available via a legacy route: GET /repos/:owner/:repo/statuses/:ref.

                                                                                                          Statuses are returned in reverse chronological order. The first status in the list will be the latest one.

                                                                                                          Parameters

                                                                                                          Name Type Description
                                                                                                          ref string Required. Ref to list the statuses from. It can be a SHA, a branch name, or a tag name.

                                                                                                          Response

                                                                                                          Status: 200 OK
                                                                                                          Link: <https://api.github.com/resource?page=2>; rel="next",
                                                                                                                <https://api.github.com/resource?page=5>; rel="last"
                                                                                                          
                                                                                                          [
                                                                                                            {
                                                                                                              "created_at": "2012-07-20T01:19:13Z",
                                                                                                              "updated_at": "2012-07-20T01:19:13Z",
                                                                                                              "state": "success",
                                                                                                              "target_url": "https://ci.example.com/1000/output",
                                                                                                              "description": "Build has completed successfully",
                                                                                                              "id": 1,
                                                                                                              "url": "https://api.github.com/repos/octocat/Hello-World/statuses/6dcb09b5b57875f334f61aebed695e2e4193db5e",
                                                                                                              "context": "continuous-integration/jenkins",
                                                                                                              "creator": {
                                                                                                                "login": "octocat",
                                                                                                                "id": 1,
                                                                                                                "avatar_url": "https://github.com/images/error/octocat_happy.gif",
                                                                                                                "gravatar_id": "",
                                                                                                                "url": "https://api.github.com/users/octocat",
                                                                                                                "html_url": "https://github.com/octocat",
                                                                                                                "followers_url": "https://api.github.com/users/octocat/followers",
                                                                                                                "following_url": "https://api.github.com/users/octocat/following{/other_user}",
                                                                                                                "gists_url": "https://api.github.com/users/octocat/gists{/gist_id}",
                                                                                                                "starred_url": "https://api.github.com/users/octocat/starred{/owner}{/repo}",
                                                                                                                "subscriptions_url": "https://api.github.com/users/octocat/subscriptions",
                                                                                                                "organizations_url": "https://api.github.com/users/octocat/orgs",
                                                                                                                "repos_url": "https://api.github.com/users/octocat/repos",
                                                                                                                "events_url": "https://api.github.com/users/octocat/events{/privacy}",
                                                                                                                "received_events_url": "https://api.github.com/users/octocat/received_events",
                                                                                                                "type": "User",
                                                                                                                "site_admin": false
                                                                                                              }
                                                                                                            }
                                                                                                          ]
                                                                                                          

                                                                                                          Get the combined status for a specific ref

                                                                                                          Users with pull access can access a combined view of commit statuses for a given ref.

                                                                                                          GET /repos/:owner/:repo/commits/:ref/status
                                                                                                          

                                                                                                          The most recent status for each context is returned, up to 100. This field paginates if there are over 100 contexts.

                                                                                                          Additionally, a combined state is returned. The state is one of:

                                                                                                          • failure if any of the contexts report as error or failure
                                                                                                          • pending if there are no statuses or a context is pending
                                                                                                          • success if the latest status for all contexts is success

                                                                                                          Parameters

                                                                                                          Name Type Description
                                                                                                          ref string Required. Ref to fetch the status for. It can be a SHA, a branch name, or a tag name.

                                                                                                          Response

                                                                                                          Status: 200 OK
                                                                                                          
                                                                                                          {
                                                                                                            "state": "success",
                                                                                                            "sha": "6dcb09b5b57875f334f61aebed695e2e4193db5e",
                                                                                                            "total_count": 2,
                                                                                                            "statuses": [
                                                                                                              {
                                                                                                                "created_at": "2012-07-20T01:19:13Z",
                                                                                                                "updated_at": "2012-07-20T01:19:13Z",
                                                                                                                "state": "success",
                                                                                                                "target_url": "https://ci.example.com/1000/output",
                                                                                                                "description": "Build has completed successfully",
                                                                                                                "id": 1,
                                                                                                                "url": "https://api.github.com/repos/octocat/Hello-World/statuses/6dcb09b5b57875f334f61aebed695e2e4193db5e",
                                                                                                                "context": "continuous-integration/jenkins"
                                                                                                              },
                                                                                                              {
                                                                                                                "created_at": "2012-08-20T01:19:13Z",
                                                                                                                "updated_at": "2012-08-20T01:19:13Z",
                                                                                                                "state": "success",
                                                                                                                "target_url": "https://ci.example.com/2000/output",
                                                                                                                "description": "Testing has completed successfully",
                                                                                                                "id": 2,
                                                                                                                "url": "https://api.github.com/repos/octocat/Hello-World/statuses/6dcb09b5b57875f334f61aebed695e2e4193db5e",
                                                                                                                "context": "security/brakeman"
                                                                                                              }
                                                                                                            ],
                                                                                                            "repository": {
                                                                                                              "id": 1296269,
                                                                                                              "owner": {
                                                                                                                "login": "octocat",
                                                                                                                "id": 1,
                                                                                                                "avatar_url": "https://github.com/images/error/octocat_happy.gif",
                                                                                                                "gravatar_id": "",
                                                                                                                "url": "https://api.github.com/users/octocat",
                                                                                                                "html_url": "https://github.com/octocat",
                                                                                                                "followers_url": "https://api.github.com/users/octocat/followers",
                                                                                                                "following_url": "https://api.github.com/users/octocat/following{/other_user}",
                                                                                                                "gists_url": "https://api.github.com/users/octocat/gists{/gist_id}",
                                                                                                                "starred_url": "https://api.github.com/users/octocat/starred{/owner}{/repo}",
                                                                                                                "subscriptions_url": "https://api.github.com/users/octocat/subscriptions",
                                                                                                                "organizations_url": "https://api.github.com/users/octocat/orgs",
                                                                                                                "repos_url": "https://api.github.com/users/octocat/repos",
                                                                                                                "events_url": "https://api.github.com/users/octocat/events{/privacy}",
                                                                                                                "received_events_url": "https://api.github.com/users/octocat/received_events",
                                                                                                                "type": "User",
                                                                                                                "site_admin": false
                                                                                                              },
                                                                                                              "name": "Hello-World",
                                                                                                              "full_name": "octocat/Hello-World",
                                                                                                              "description": "This your first repo!",
                                                                                                              "private": false,
                                                                                                              "fork": false,
                                                                                                              "url": "https://api.github.com/repos/octocat/Hello-World",
                                                                                                              "html_url": "https://github.com/octocat/Hello-World"
                                                                                                            },
                                                                                                            "commit_url": "https://api.github.com/repos/octocat/Hello-World/6dcb09b5b57875f334f61aebed695e2e4193db5e",
                                                                                                            "url": "https://api.github.com/repos/octocat/Hello-World/6dcb09b5b57875f334f61aebed695e2e4193db5e/status"
                                                                                                          }
                                                                                                          
                                                                                                          tmp/developer.github.com/v3/repos/traffic/index.html Traffic | GitHub Developer Guide

                                                                                                          Traffic

                                                                                                          For repositories that you have push access to, the traffic API provides access to the information provided in the graphs section.

                                                                                                          List referrers

                                                                                                          Get the top 10 referrers over the last 14 days.

                                                                                                          GET /repos/:owner/:repo/traffic/popular/referrers
                                                                                                          

                                                                                                          Response

                                                                                                          Status: 200 OK
                                                                                                          
                                                                                                          [
                                                                                                            {
                                                                                                              "referrer": "Google",
                                                                                                              "count": 4,
                                                                                                              "uniques": 3
                                                                                                            },
                                                                                                            {
                                                                                                              "referrer": "stackoverflow.com",
                                                                                                              "count": 2,
                                                                                                              "uniques": 2
                                                                                                            },
                                                                                                            {
                                                                                                              "referrer": "eggsonbread.com",
                                                                                                              "count": 1,
                                                                                                              "uniques": 1
                                                                                                            },
                                                                                                            {
                                                                                                              "referrer": "yandex.ru",
                                                                                                              "count": 1,
                                                                                                              "uniques": 1
                                                                                                            }
                                                                                                          ]
                                                                                                          

                                                                                                          List paths

                                                                                                          Get the top 10 popular contents over the last 14 days.

                                                                                                          GET /repos/:owner/:repo/traffic/popular/paths
                                                                                                          

                                                                                                          Response

                                                                                                          Status: 200 OK
                                                                                                          
                                                                                                          [
                                                                                                            {
                                                                                                              "path": "/github/hubot",
                                                                                                              "title": "github/hubot: A customizable life embetterment robot.",
                                                                                                              "count": 3542,
                                                                                                              "uniques": 2225
                                                                                                            },
                                                                                                            {
                                                                                                              "path": "/github/hubot/blob/master/docs/scripting.md",
                                                                                                              "title": "hubot/scripting.md at master · github/hubot · GitHub",
                                                                                                              "count": 1707,
                                                                                                              "uniques": 804
                                                                                                            },
                                                                                                            {
                                                                                                              "path": "/github/hubot/tree/master/docs",
                                                                                                              "title": "hubot/docs at master · github/hubot · GitHub",
                                                                                                              "count": 685,
                                                                                                              "uniques": 435
                                                                                                            },
                                                                                                            {
                                                                                                              "path": "/github/hubot/tree/master/src",
                                                                                                              "title": "hubot/src at master · github/hubot · GitHub",
                                                                                                              "count": 577,
                                                                                                              "uniques": 347
                                                                                                            },
                                                                                                            {
                                                                                                              "path": "/github/hubot/blob/master/docs/index.md",
                                                                                                              "title": "hubot/index.md at master · github/hubot · GitHub",
                                                                                                              "count": 379,
                                                                                                              "uniques": 259
                                                                                                            },
                                                                                                            {
                                                                                                              "path": "/github/hubot/blob/master/docs/adapters.md",
                                                                                                              "title": "hubot/adapters.md at master · github/hubot · GitHub",
                                                                                                              "count": 354,
                                                                                                              "uniques": 201
                                                                                                            },
                                                                                                            {
                                                                                                              "path": "/github/hubot/tree/master/examples",
                                                                                                              "title": "hubot/examples at master · github/hubot · GitHub",
                                                                                                              "count": 340,
                                                                                                              "uniques": 260
                                                                                                            },
                                                                                                            {
                                                                                                              "path": "/github/hubot/blob/master/docs/deploying/heroku.md",
                                                                                                              "title": "hubot/heroku.md at master · github/hubot · GitHub",
                                                                                                              "count": 324,
                                                                                                              "uniques": 217
                                                                                                            },
                                                                                                            {
                                                                                                              "path": "/github/hubot/blob/master/src/robot.coffee",
                                                                                                              "title": "hubot/robot.coffee at master · github/hubot · GitHub",
                                                                                                              "count": 293,
                                                                                                              "uniques": 191
                                                                                                            },
                                                                                                            {
                                                                                                              "path": "/github/hubot/blob/master/LICENSE.md",
                                                                                                              "title": "hubot/LICENSE.md at master · github/hubot · GitHub",
                                                                                                              "count": 281,
                                                                                                              "uniques": 222
                                                                                                            }
                                                                                                          ]
                                                                                                          

                                                                                                          Views

                                                                                                          Get the total number of views and breakdown per day or week for the last 14 days. Timestamps are aligned to UTC midnight of the beginning of the day or week. Week begins on Monday.

                                                                                                          GET  /repos/:owner/:repo/traffic/views
                                                                                                          

                                                                                                          Parameters

                                                                                                          Name Type Description
                                                                                                          per string Must be one of: day, week. Default: day

                                                                                                          Response

                                                                                                          Status: 200 OK
                                                                                                          
                                                                                                          {
                                                                                                            "count": 14850,
                                                                                                            "uniques": 3782,
                                                                                                            "views": [
                                                                                                              {
                                                                                                                "timestamp": "2016-10-10T00:00:00Z",
                                                                                                                "count": 440,
                                                                                                                "uniques": 143
                                                                                                              },
                                                                                                              {
                                                                                                                "timestamp": "2016-10-11T00:00:00Z",
                                                                                                                "count": 1308,
                                                                                                                "uniques": 414
                                                                                                              },
                                                                                                              {
                                                                                                                "timestamp": "2016-10-12T00:00:00Z",
                                                                                                                "count": 1486,
                                                                                                                "uniques": 452
                                                                                                              },
                                                                                                              {
                                                                                                                "timestamp": "2016-10-13T00:00:00Z",
                                                                                                                "count": 1170,
                                                                                                                "uniques": 401
                                                                                                              },
                                                                                                              {
                                                                                                                "timestamp": "2016-10-14T00:00:00Z",
                                                                                                                "count": 868,
                                                                                                                "uniques": 266
                                                                                                              },
                                                                                                              {
                                                                                                                "timestamp": "2016-10-15T00:00:00Z",
                                                                                                                "count": 495,
                                                                                                                "uniques": 157
                                                                                                              },
                                                                                                              {
                                                                                                                "timestamp": "2016-10-16T00:00:00Z",
                                                                                                                "count": 524,
                                                                                                                "uniques": 175
                                                                                                              },
                                                                                                              {
                                                                                                                "timestamp": "2016-10-17T00:00:00Z",
                                                                                                                "count": 1263,
                                                                                                                "uniques": 412
                                                                                                              },
                                                                                                              {
                                                                                                                "timestamp": "2016-10-18T00:00:00Z",
                                                                                                                "count": 1402,
                                                                                                                "uniques": 417
                                                                                                              },
                                                                                                              {
                                                                                                                "timestamp": "2016-10-19T00:00:00Z",
                                                                                                                "count": 1394,
                                                                                                                "uniques": 424
                                                                                                              },
                                                                                                              {
                                                                                                                "timestamp": "2016-10-20T00:00:00Z",
                                                                                                                "count": 1492,
                                                                                                                "uniques": 448
                                                                                                              },
                                                                                                              {
                                                                                                                "timestamp": "2016-10-21T00:00:00Z",
                                                                                                                "count": 1153,
                                                                                                                "uniques": 332
                                                                                                              },
                                                                                                              {
                                                                                                                "timestamp": "2016-10-22T00:00:00Z",
                                                                                                                "count": 566,
                                                                                                                "uniques": 168
                                                                                                              },
                                                                                                              {
                                                                                                                "timestamp": "2016-10-23T00:00:00Z",
                                                                                                                "count": 675,
                                                                                                                "uniques": 184
                                                                                                              },
                                                                                                              {
                                                                                                                "timestamp": "2016-10-24T00:00:00Z",
                                                                                                                "count": 614,
                                                                                                                "uniques": 237
                                                                                                              }
                                                                                                            ]
                                                                                                          }
                                                                                                          

                                                                                                          Clones

                                                                                                          Get the total number of clones and breakdown per day or week for the last 14 days. Timestamps are aligned to UTC midnight of the beginning of the day or week. Week begins on Monday.

                                                                                                          GET  /repos/:owner/:repo/traffic/clones
                                                                                                          

                                                                                                          Parameters

                                                                                                          Name Type Description
                                                                                                          per string Must be one of: day, week. Default: day

                                                                                                          Response

                                                                                                          Status: 200 OK
                                                                                                          
                                                                                                          {
                                                                                                            "count": 173,
                                                                                                            "uniques": 128,
                                                                                                            "clones": [
                                                                                                              {
                                                                                                                "timestamp": "2016-10-10T00:00:00Z",
                                                                                                                "count": 2,
                                                                                                                "uniques": 1
                                                                                                              },
                                                                                                              {
                                                                                                                "timestamp": "2016-10-11T00:00:00Z",
                                                                                                                "count": 17,
                                                                                                                "uniques": 16
                                                                                                              },
                                                                                                              {
                                                                                                                "timestamp": "2016-10-12T00:00:00Z",
                                                                                                                "count": 21,
                                                                                                                "uniques": 15
                                                                                                              },
                                                                                                              {
                                                                                                                "timestamp": "2016-10-13T00:00:00Z",
                                                                                                                "count": 8,
                                                                                                                "uniques": 7
                                                                                                              },
                                                                                                              {
                                                                                                                "timestamp": "2016-10-14T00:00:00Z",
                                                                                                                "count": 5,
                                                                                                                "uniques": 5
                                                                                                              },
                                                                                                              {
                                                                                                                "timestamp": "2016-10-15T00:00:00Z",
                                                                                                                "count": 2,
                                                                                                                "uniques": 2
                                                                                                              },
                                                                                                              {
                                                                                                                "timestamp": "2016-10-16T00:00:00Z",
                                                                                                                "count": 8,
                                                                                                                "uniques": 7
                                                                                                              },
                                                                                                              {
                                                                                                                "timestamp": "2016-10-17T00:00:00Z",
                                                                                                                "count": 26,
                                                                                                                "uniques": 15
                                                                                                              },
                                                                                                              {
                                                                                                                "timestamp": "2016-10-18T00:00:00Z",
                                                                                                                "count": 19,
                                                                                                                "uniques": 17
                                                                                                              },
                                                                                                              {
                                                                                                                "timestamp": "2016-10-19T00:00:00Z",
                                                                                                                "count": 19,
                                                                                                                "uniques": 14
                                                                                                              },
                                                                                                              {
                                                                                                                "timestamp": "2016-10-20T00:00:00Z",
                                                                                                                "count": 19,
                                                                                                                "uniques": 15
                                                                                                              },
                                                                                                              {
                                                                                                                "timestamp": "2016-10-21T00:00:00Z",
                                                                                                                "count": 9,
                                                                                                                "uniques": 7
                                                                                                              },
                                                                                                              {
                                                                                                                "timestamp": "2016-10-22T00:00:00Z",
                                                                                                                "count": 5,
                                                                                                                "uniques": 5
                                                                                                              },
                                                                                                              {
                                                                                                                "timestamp": "2016-10-23T00:00:00Z",
                                                                                                                "count": 6,
                                                                                                                "uniques": 5
                                                                                                              },
                                                                                                              {
                                                                                                                "timestamp": "2016-10-24T00:00:00Z",
                                                                                                                "count": 7,
                                                                                                                "uniques": 5
                                                                                                              }
                                                                                                            ]
                                                                                                          }
                                                                                                          
                                                                                                          tmp/developer.github.com/v3/scim/index.html SCIM | GitHub Developer Guide

                                                                                                          SCIM

                                                                                                          SCIM Provisioning for Organizations

                                                                                                          The SCIM API is used by SCIM-enabled Identity Providers (IdPs) to automate provisioning of GitHub organization membership. The GitHub API is based on version 2.0 of the SCIM standard.

                                                                                                          Please note that the SCIM API is available only to Business Plan with SAML SSO enabled.

                                                                                                          Note: The SCIM API on GitHub is currently available for developers to preview. To access the API, you must provide a custom media type in the Accept header:

                                                                                                          application/vnd.github.cloud-9-preview+json+scim
                                                                                                          

                                                                                                          Warning: The API may change without advance notice during the preview period. Preview features are not supported for production use. If you experience any issues, contact GitHub support.

                                                                                                          Authenticating calls to the SCIM API

                                                                                                          The API expects an OAuth 2.0 Bearer token to be passed to the Authorization header. You may also use Personal Access Tokens but they must be whitelisted from your token settings page

                                                                                                          Mapping of SAML and SCIM data

                                                                                                          Make sure to configure your SAML Identity Provider and your SCIM client to have identical NameID and userName for the same user. This provides the ability for a user authenticating using SAML to be linked to their identity that is already provisioned using SCIM.

                                                                                                          Supported SCIM User attributes

                                                                                                          Name Type Description
                                                                                                          userName string The username for the user
                                                                                                          name.givenName string User first name
                                                                                                          name.lastName string User last name
                                                                                                          emails array List of user emails
                                                                                                          externalId string External identifier (generated by the SAML SSO provider)
                                                                                                          id string Identifier generated by the GitHub SCIM endpoint
                                                                                                          active boolean Used to indicate whether the identity is active (true) or should be deprovisioned (false)

                                                                                                          Note: Endpoints for the SCIM API are case sensitive: the first letter in the Users endpoint must be capitalized. For example:

                                                                                                          GET /scim/v2/organizations/:organization/Users/:id
                                                                                                          

                                                                                                          Get a list of provisioned identities

                                                                                                          GET https://api.github.com/scim/v2/organizations/:organization/Users
                                                                                                          

                                                                                                          Parameters

                                                                                                          Name Type Description
                                                                                                          startIndex integer Used for pagination: the index of the first result to return
                                                                                                          count integer Used for pagination: the number of results to return
                                                                                                          filter string Only eq type filters are supported

                                                                                                          Filter parameter

                                                                                                          You can filter results with the id, userName, emails and external_id query parameters.

                                                                                                          GET https://api.github.com/scim/v2/organizations/:organization/Users?filter=userName eq user@example.com
                                                                                                          

                                                                                                          Response

                                                                                                          Retrieves a paginated list of all provisioned organization members, including pending invitations.

                                                                                                          Status: 200 OK
                                                                                                          
                                                                                                          {
                                                                                                            "schemas": [
                                                                                                              "urn:ietf:params:scim:api:messages:2.0:ListResponse"
                                                                                                            ],
                                                                                                            "totalResults": 2,
                                                                                                            "itemsPerPage": 2,
                                                                                                            "startIndex": 1,
                                                                                                            "Resources": [
                                                                                                              {
                                                                                                                "schemas": [
                                                                                                                  "urn:ietf:params:scim:schemas:core:2.0:User"
                                                                                                                ],
                                                                                                                "id": "8773fe-ffff-42837498757",
                                                                                                                "externalId": "239482347928374",
                                                                                                                "userName": "mona@example.com",
                                                                                                                "name": {
                                                                                                                  "givenName": "mona",
                                                                                                                  "familyName": "octocat"
                                                                                                                },
                                                                                                                "active": true,
                                                                                                                "meta": {
                                                                                                                  "resourceType": "User",
                                                                                                                  "created": "2017-03-09T16:11:13-05:00",
                                                                                                                  "lastModified": "2017-03-09T16:11:13-05:00"
                                                                                                                }
                                                                                                              },
                                                                                                              {
                                                                                                                "schemas": [
                                                                                                                  "urn:ietf:params:scim:schemas:core:2.0:User"
                                                                                                                ],
                                                                                                                "id": "77563764-eb6-24-0598234-958243",
                                                                                                                "externalId": "sdfoiausdofiua",
                                                                                                                "userName": "hubot@example.com",
                                                                                                                "name": {
                                                                                                                  "givenName": "hu",
                                                                                                                  "familyName": "bot"
                                                                                                                },
                                                                                                                "active": true,
                                                                                                                "meta": {
                                                                                                                  "resourceType": "User",
                                                                                                                  "created": "2017-03-09T16:11:13-05:00",
                                                                                                                  "lastModified": "2017-03-09T16:11:13-05:00"
                                                                                                                }
                                                                                                              }
                                                                                                            ]
                                                                                                          }
                                                                                                          

                                                                                                          Get provisioning details for a single user

                                                                                                          GET /scim/v2/organizations/:organization/Users/:id
                                                                                                          

                                                                                                          Response

                                                                                                          Status: 200 OK
                                                                                                          
                                                                                                          {
                                                                                                            "schemas": [
                                                                                                              "urn:ietf:params:scim:schemas:core:2.0:User"
                                                                                                            ],
                                                                                                            "id": "77563764-eb6-24-0598234-958243",
                                                                                                            "externalId": "sdfoiausdofiua",
                                                                                                            "userName": "hubot@example.com",
                                                                                                            "name": {
                                                                                                              "givenName": "hu",
                                                                                                              "familyName": "bot"
                                                                                                            },
                                                                                                            "active": true,
                                                                                                            "meta": {
                                                                                                              "resourceType": "User",
                                                                                                              "created": "2017-03-09T16:11:13-05:00",
                                                                                                              "lastModified": "2017-03-09T16:11:13-05:00"
                                                                                                            }
                                                                                                          }
                                                                                                          

                                                                                                          Provision and invite users

                                                                                                          Provision organization membership for and send activation emails to a list of email addresses.

                                                                                                          POST /scim/v2/organizations/:organization/Users
                                                                                                          

                                                                                                          Response

                                                                                                          Status: 200 OK
                                                                                                          
                                                                                                          {
                                                                                                            "schemas": [
                                                                                                              "urn:ietf:params:scim:schemas:core:2.0:User"
                                                                                                            ],
                                                                                                            "id": "edefdfedf-050c-11e7-8d32",
                                                                                                            "externalId": "a7d0f98382",
                                                                                                            "userName": "mona.octocat@okta.example.com",
                                                                                                            "name": {
                                                                                                              "givenName": "Mona",
                                                                                                              "familyName": "Octocat"
                                                                                                            },
                                                                                                            "active": true,
                                                                                                            "meta": {
                                                                                                              "resourceType": "User",
                                                                                                              "created": "2017-03-09T16:11:13-05:00",
                                                                                                              "lastModified": "2017-03-09T16:11:13-05:00"
                                                                                                            }
                                                                                                          }
                                                                                                          

                                                                                                          Update a provisioned organization membership

                                                                                                          PUT /scim/v2/organizations/:organization/Users/:id
                                                                                                          

                                                                                                          Note: Setting active: false removes the user from the organization, deletes the external identity, and deletes the associated :id.

                                                                                                          Response

                                                                                                          Status: 200 OK
                                                                                                          
                                                                                                          {
                                                                                                            "schemas": [
                                                                                                              "urn:ietf:params:scim:schemas:core:2.0:User"
                                                                                                            ],
                                                                                                            "id": "edefdfedf-050c-11e7-8d32",
                                                                                                            "externalId": "a7d0f98382",
                                                                                                            "userName": "mona.octocat@okta.example.com",
                                                                                                            "name": {
                                                                                                              "givenName": "Mona",
                                                                                                              "familyName": "Octocat"
                                                                                                            },
                                                                                                            "active": true,
                                                                                                            "meta": {
                                                                                                              "resourceType": "User",
                                                                                                              "created": "2017-03-09T16:11:13-05:00",
                                                                                                              "lastModified": "2017-03-09T16:11:13-05:00"
                                                                                                            }
                                                                                                          }
                                                                                                          

                                                                                                          Update a user attribute

                                                                                                          PATCH /scim/v2/organizations/:organization/Users/:id
                                                                                                          

                                                                                                          Note: Setting active: false removes the user from the organization, deletes the external identity, and deletes the associated :id.

                                                                                                          Response

                                                                                                          Status: 200 OK
                                                                                                          
                                                                                                          {
                                                                                                            "schemas": [
                                                                                                              "urn:ietf:params:scim:schemas:core:2.0:User"
                                                                                                            ],
                                                                                                            "id": "edefdfedf-050c-11e7-8d32",
                                                                                                            "externalId": "a7d0f98382",
                                                                                                            "userName": "mona.octocat@okta.example.com",
                                                                                                            "name": {
                                                                                                              "givenName": "Mona",
                                                                                                              "familyName": "Octocat"
                                                                                                            },
                                                                                                            "active": true,
                                                                                                            "meta": {
                                                                                                              "resourceType": "User",
                                                                                                              "created": "2017-03-09T16:11:13-05:00",
                                                                                                              "lastModified": "2017-03-09T16:11:13-05:00"
                                                                                                            }
                                                                                                          }
                                                                                                          

                                                                                                          Remove a user from the organization

                                                                                                          DELETE /scim/v2/organizations/:organization/Users/:id
                                                                                                          

                                                                                                          Response

                                                                                                          Status: 204 No Content
                                                                                                          
                                                                                                          tmp/developer.github.com/v3/search/index.html Search | GitHub Developer Guide

                                                                                                          Search

                                                                                                          Note: The topics property for repositories on GitHub is currently available for developers to preview. To view the topics property in calls that return repository results, you must provide a custom media type in the Accept header:

                                                                                                          application/vnd.github.mercy-preview+json
                                                                                                          

                                                                                                          Warning: The API may change without advance notice during the preview period. Preview features are not supported for production use. If you experience any issues, contact GitHub support.

                                                                                                          About the Search API

                                                                                                          The Search API is optimized to help you find the specific item you're looking for (e.g., a specific user, a specific file in a repository, etc.). Think of it the way you think of performing a search on Google. It's designed to help you find the one result you're looking for (or maybe the few results you're looking for). Just like searching on Google, you sometimes want to see a few pages of search results so that you can find the item that best meets your needs. To satisfy that need, the GitHub Search API provides up to 1,000 results for each search.

                                                                                                          Ranking search results

                                                                                                          Unless another sort option is provided as a query parameter, results are sorted by best match, as indicated by the score field for each item returned. This is a computed value representing the relevance of an item relative to the other items in the result set. Multiple factors are combined to boost the most relevant item to the top of the result list.

                                                                                                          Rate limit

                                                                                                          The Search API has a custom rate limit. For requests using Basic Authentication, OAuth, or client ID and secret, you can make up to 30 requests per minute. For unauthenticated requests, the rate limit allows you to make up to 10 requests per minute.

                                                                                                          See the rate limit documentation for details on determining your current rate limit status.

                                                                                                          Timeouts and incomplete results

                                                                                                          To keep the Search API fast for everyone, we limit how long any individual query can run. For queries that exceed the time limit, the API returns the matches that were already found prior to the timeout, and the response has the incomplete_results property set to true.

                                                                                                          Reaching a timeout does not necessarily mean that search results are incomplete. More results might have been found, but also might not.

                                                                                                          Search repositories

                                                                                                          Find repositories via various criteria. This method returns up to 100 results per page.

                                                                                                          GET /search/repositories
                                                                                                          

                                                                                                          Parameters

                                                                                                          Name Type Description
                                                                                                          q string The search keywords, as well as any qualifiers.
                                                                                                          sort string The sort field. One of stars, forks, or updated. Default: results are sorted by best match.
                                                                                                          order string The sort order if sort parameter is provided. One of asc or desc. Default: desc

                                                                                                          The q search term can also contain any combination of the supported repository search qualifiers as described by the in-browser repository search documentation and search syntax documentation:

                                                                                                          • created or pushed Filters repositories based on date of creation, or when they were last updated.
                                                                                                          • fork Filters whether forked repositories should be included (true) or only forked repositories should be returned (only).
                                                                                                          • forks Filters repositories based on the number of forks.
                                                                                                          • in Qualifies which fields are searched. With this qualifier you can restrict the search to just the repository name, description, readme, or any combination of these.
                                                                                                          • language Searches repositories based on the language they're written in.
                                                                                                          • license Filters repositories by license or license family, using the license keyword.
                                                                                                          • repo or user Limits searches to a specific repository or user.
                                                                                                          • size Finds repositories that match a certain size (in kilobytes).
                                                                                                          • stars Searches repositories based on the number of stars.
                                                                                                          • topic Filters repositories based on the specified topic.
                                                                                                          • archived Filters whether archived repositories should be included (true) or not (false).

                                                                                                            You can search for multiple topics by adding more topic: instances. For example:

                                                                                                            curl -H "Authentication: token TOKEN" \
                                                                                                            -H "Accept: application/vnd.github.mercy-preview+json" \
                                                                                                            https://api.github.com/search/repositories?q=topic:ruby+topic:rails
                                                                                                            

                                                                                                          Example

                                                                                                          Suppose you want to search for popular Tetris repositories written in Assembly. Your query might look like this.

                                                                                                          https://api.github.com/search/repositories?q=tetris+language:assembly&sort=stars&order=desc
                                                                                                          

                                                                                                          In this request, we're searching for repositories with the word tetris in the name, the description, or the README. We're limiting the results to only find repositories where the primary language is Assembly. We're sorting by stars in descending order, so that the most popular repositories appear first in the search results.

                                                                                                          Status: 200 OK
                                                                                                          Link: <https://api.github.com/resource?page=2>; rel="next",
                                                                                                                <https://api.github.com/resource?page=5>; rel="last"
                                                                                                          X-RateLimit-Limit: 20
                                                                                                          X-RateLimit-Remaining: 19
                                                                                                          
                                                                                                          {
                                                                                                            "total_count": 40,
                                                                                                            "incomplete_results": false,
                                                                                                            "items": [
                                                                                                              {
                                                                                                                "id": 3081286,
                                                                                                                "name": "Tetris",
                                                                                                                "full_name": "dtrupenn/Tetris",
                                                                                                                "owner": {
                                                                                                                  "login": "dtrupenn",
                                                                                                                  "id": 872147,
                                                                                                                  "avatar_url": "https://secure.gravatar.com/avatar/e7956084e75f239de85d3a31bc172ace?d=https://a248.e.akamai.net/assets.github.com%2Fimages%2Fgravatars%2Fgravatar-user-420.png",
                                                                                                                  "gravatar_id": "",
                                                                                                                  "url": "https://api.github.com/users/dtrupenn",
                                                                                                                  "received_events_url": "https://api.github.com/users/dtrupenn/received_events",
                                                                                                                  "type": "User"
                                                                                                                },
                                                                                                                "private": false,
                                                                                                                "html_url": "https://github.com/dtrupenn/Tetris",
                                                                                                                "description": "A C implementation of Tetris using Pennsim through LC4",
                                                                                                                "fork": false,
                                                                                                                "url": "https://api.github.com/repos/dtrupenn/Tetris",
                                                                                                                "created_at": "2012-01-01T00:31:50Z",
                                                                                                                "updated_at": "2013-01-05T17:58:47Z",
                                                                                                                "pushed_at": "2012-01-01T00:37:02Z",
                                                                                                                "homepage": "",
                                                                                                                "size": 524,
                                                                                                                "stargazers_count": 1,
                                                                                                                "watchers_count": 1,
                                                                                                                "language": "Assembly",
                                                                                                                "forks_count": 0,
                                                                                                                "open_issues_count": 0,
                                                                                                                "master_branch": "master",
                                                                                                                "default_branch": "master",
                                                                                                                "score": 10.309712
                                                                                                              }
                                                                                                            ]
                                                                                                          }
                                                                                                          

                                                                                                          Highlighting Repository Search Results

                                                                                                          Some API consumers will want to highlight the matching search terms when displaying search results. The API offers additional metadata to support this use case. To get this metadata in your search results, specify the text-match media type in your Accept header. For example, via curl, the above query would look like this:

                                                                                                          curl -H 'Accept: application/vnd.github.v3.text-match+json' \
                                                                                                            'https://api.github.com/search/repositories?q=tetris+language:assembly&sort=stars&order=desc'
                                                                                                          

                                                                                                          This produces the same JSON payload as above, with an extra key called text_matches, an array of objects. These objects provide information such as the position of your search terms within the text, as well as the property that included the search term.

                                                                                                          When searching for repositories, you can get text match metadata for the name and description fields. (See the section on text match metadata for full details.)

                                                                                                          Here's an example response:

                                                                                                          {
                                                                                                            "text_matches": [
                                                                                                              {
                                                                                                                "object_url": "https://api.github.com/repositories/3081286",
                                                                                                                "object_type": "Repository",
                                                                                                                "property": "name",
                                                                                                                "fragment": "Tetris",
                                                                                                                "matches": [
                                                                                                                  {
                                                                                                                    "text": "Tetris",
                                                                                                                    "indices": [
                                                                                                                      0,
                                                                                                                      6
                                                                                                                    ]
                                                                                                                  }
                                                                                                                ]
                                                                                                              },
                                                                                                              {
                                                                                                                "object_url": "https://api.github.com/repositories/3081286",
                                                                                                                "object_type": "Repository",
                                                                                                                "property": "description",
                                                                                                                "fragment": "A C implementation of Tetris using Pennsim through LC4",
                                                                                                                "matches": [
                                                                                                                  {
                                                                                                                    "text": "Tetris",
                                                                                                                    "indices": [
                                                                                                                      22,
                                                                                                                      28
                                                                                                                    ]
                                                                                                                  }
                                                                                                                ]
                                                                                                              }
                                                                                                            ]
                                                                                                          }
                                                                                                          

                                                                                                          Search commits

                                                                                                          The Commit Search API is currently available for developers to preview. During the preview period, the APIs may change without advance notice. Please see the blog post for full details.

                                                                                                          To access the API you must provide a custom media type in the Accept header:

                                                                                                            application/vnd.github.cloak-preview
                                                                                                          

                                                                                                          Find commits via various criteria. This method returns up to 100 results per page.

                                                                                                          GET /search/commits
                                                                                                          

                                                                                                          Considerations for commit search

                                                                                                          Only the default branch is considered. In most cases, this will be the master branch.

                                                                                                          Parameters

                                                                                                          Name Type Description
                                                                                                          q string The search terms.
                                                                                                          sort string The sort field. Can be author-date or committer-date. Default: results are sorted by best match.
                                                                                                          order string The sort order if sort parameter is provided. One of asc or desc. Default: desc

                                                                                                          The q search term can also contain any combination of the supported commit search qualifiers as described by the in-browser commit search documentation and search syntax documentation:

                                                                                                          • author Matches commits authored by a user (based on email settings).
                                                                                                          • committer Matches commits committed by a user (based on email settings).
                                                                                                          • author-name Matches commits by author name.
                                                                                                          • committer-name Matches commits by committer name.
                                                                                                          • author-email Matches commits by author email.
                                                                                                          • committer-email Matches commits by committer email.
                                                                                                          • author-date Matches commits by author date range.
                                                                                                          • committer-date Matches commits by committer date range.
                                                                                                          • merge true filters to merge commits, false filters out merge commits.
                                                                                                          • hash Matches commits by hash.
                                                                                                          • parent Matches commits that have a particular parent.
                                                                                                          • tree Matches commits by tree hash.
                                                                                                          • is Matches public or private repositories.
                                                                                                          • user, org, or repo Limits searches to a specific user, organization, or repository.

                                                                                                          Example

                                                                                                          Suppose you want to find commits related to CSS in the octocat/Spoon-Knife repository. Your query would look something like this:

                                                                                                          https://api.github.com/search/commits?q=repo:octocat/Spoon-Knife+css
                                                                                                          
                                                                                                          Status: 200 OK
                                                                                                          Link: <https://api.github.com/resource?page=2>; rel="next",
                                                                                                                <https://api.github.com/resource?page=5>; rel="last"
                                                                                                          X-RateLimit-Limit: 20
                                                                                                          X-RateLimit-Remaining: 19
                                                                                                          
                                                                                                          {
                                                                                                            "total_count": 1,
                                                                                                            "incomplete_results": false,
                                                                                                            "items": [
                                                                                                              {
                                                                                                                "url": "https://api.github.com/repos/octocat/Spoon-Knife/commits/bb4cc8d3b2e14b3af5df699876dd4ff3acd00b7f",
                                                                                                                "sha": "bb4cc8d3b2e14b3af5df699876dd4ff3acd00b7f",
                                                                                                                "html_url": "https://github.com/octocat/Spoon-Knife/commit/bb4cc8d3b2e14b3af5df699876dd4ff3acd00b7f",
                                                                                                                "comments_url": "https://api.github.com/repos/octocat/Spoon-Knife/commits/bb4cc8d3b2e14b3af5df699876dd4ff3acd00b7f/comments",
                                                                                                                "commit": {
                                                                                                                  "url": "https://api.github.com/repos/octocat/Spoon-Knife/git/commits/bb4cc8d3b2e14b3af5df699876dd4ff3acd00b7f",
                                                                                                                  "author": {
                                                                                                                    "date": "2014-02-04T14:38:36-08:00",
                                                                                                                    "name": "The Octocat",
                                                                                                                    "email": "octocat@nowhere.com"
                                                                                                                  },
                                                                                                                  "committer": {
                                                                                                                    "date": "2014-02-12T15:18:55-08:00",
                                                                                                                    "name": "The Octocat",
                                                                                                                    "email": "octocat@nowhere.com"
                                                                                                                  },
                                                                                                                  "message": "Create styles.css and updated README",
                                                                                                                  "tree": {
                                                                                                                    "url": "https://api.github.com/repos/octocat/Spoon-Knife/git/trees/a639e96f9038797fba6e0469f94a4b0cc459fa68",
                                                                                                                    "sha": "a639e96f9038797fba6e0469f94a4b0cc459fa68"
                                                                                                                  },
                                                                                                                  "comment_count": 8
                                                                                                                },
                                                                                                                "author": {
                                                                                                                  "login": "octocat",
                                                                                                                  "id": 583231,
                                                                                                                  "avatar_url": "https://avatars.githubusercontent.com/u/583231?v=3",
                                                                                                                  "gravatar_id": "",
                                                                                                                  "url": "https://api.github.com/users/octocat",
                                                                                                                  "html_url": "https://github.com/octocat",
                                                                                                                  "followers_url": "https://api.github.com/users/octocat/followers",
                                                                                                                  "following_url": "https://api.github.com/users/octocat/following{/other_user}",
                                                                                                                  "gists_url": "https://api.github.com/users/octocat/gists{/gist_id}",
                                                                                                                  "starred_url": "https://api.github.com/users/octocat/starred{/owner}{/repo}",
                                                                                                                  "subscriptions_url": "https://api.github.com/users/octocat/subscriptions",
                                                                                                                  "organizations_url": "https://api.github.com/users/octocat/orgs",
                                                                                                                  "repos_url": "https://api.github.com/users/octocat/repos",
                                                                                                                  "events_url": "https://api.github.com/users/octocat/events{/privacy}",
                                                                                                                  "received_events_url": "https://api.github.com/users/octocat/received_events",
                                                                                                                  "type": "User",
                                                                                                                  "site_admin": false
                                                                                                                },
                                                                                                                "committer": {
                                                                                                                  "login": "octocat",
                                                                                                                  "id": 583231,
                                                                                                                  "avatar_url": "https://avatars.githubusercontent.com/u/583231?v=3",
                                                                                                                  "gravatar_id": "",
                                                                                                                  "url": "https://api.github.com/users/octocat",
                                                                                                                  "html_url": "https://github.com/octocat",
                                                                                                                  "followers_url": "https://api.github.com/users/octocat/followers",
                                                                                                                  "following_url": "https://api.github.com/users/octocat/following{/other_user}",
                                                                                                                  "gists_url": "https://api.github.com/users/octocat/gists{/gist_id}",
                                                                                                                  "starred_url": "https://api.github.com/users/octocat/starred{/owner}{/repo}",
                                                                                                                  "subscriptions_url": "https://api.github.com/users/octocat/subscriptions",
                                                                                                                  "organizations_url": "https://api.github.com/users/octocat/orgs",
                                                                                                                  "repos_url": "https://api.github.com/users/octocat/repos",
                                                                                                                  "events_url": "https://api.github.com/users/octocat/events{/privacy}",
                                                                                                                  "received_events_url": "https://api.github.com/users/octocat/received_events",
                                                                                                                  "type": "User",
                                                                                                                  "site_admin": false
                                                                                                                },
                                                                                                                "parents": [
                                                                                                                  {
                                                                                                                    "url": "https://api.github.com/repos/octocat/Spoon-Knife/commits/a30c19e3f13765a3b48829788bc1cb8b4e95cee4",
                                                                                                                    "html_url": "https://github.com/octocat/Spoon-Knife/commit/a30c19e3f13765a3b48829788bc1cb8b4e95cee4",
                                                                                                                    "sha": "a30c19e3f13765a3b48829788bc1cb8b4e95cee4"
                                                                                                                  }
                                                                                                                ],
                                                                                                                "repository": {
                                                                                                                  "id": 1300192,
                                                                                                                  "name": "Spoon-Knife",
                                                                                                                  "full_name": "octocat/Spoon-Knife",
                                                                                                                  "owner": {
                                                                                                                    "login": "octocat",
                                                                                                                    "id": 583231,
                                                                                                                    "avatar_url": "https://avatars.githubusercontent.com/u/583231?v=3",
                                                                                                                    "gravatar_id": "",
                                                                                                                    "url": "https://api.github.com/users/octocat",
                                                                                                                    "html_url": "https://github.com/octocat",
                                                                                                                    "followers_url": "https://api.github.com/users/octocat/followers",
                                                                                                                    "following_url": "https://api.github.com/users/octocat/following{/other_user}",
                                                                                                                    "gists_url": "https://api.github.com/users/octocat/gists{/gist_id}",
                                                                                                                    "starred_url": "https://api.github.com/users/octocat/starred{/owner}{/repo}",
                                                                                                                    "subscriptions_url": "https://api.github.com/users/octocat/subscriptions",
                                                                                                                    "organizations_url": "https://api.github.com/users/octocat/orgs",
                                                                                                                    "repos_url": "https://api.github.com/users/octocat/repos",
                                                                                                                    "events_url": "https://api.github.com/users/octocat/events{/privacy}",
                                                                                                                    "received_events_url": "https://api.github.com/users/octocat/received_events",
                                                                                                                    "type": "User",
                                                                                                                    "site_admin": false
                                                                                                                  },
                                                                                                                  "private": false,
                                                                                                                  "html_url": "https://github.com/octocat/Spoon-Knife",
                                                                                                                  "description": "This repo is for demonstration purposes only.",
                                                                                                                  "fork": false,
                                                                                                                  "url": "https://api.github.com/repos/octocat/Spoon-Knife",
                                                                                                                  "forks_url": "https://api.github.com/repos/octocat/Spoon-Knife/forks",
                                                                                                                  "keys_url": "https://api.github.com/repos/octocat/Spoon-Knife/keys{/key_id}",
                                                                                                                  "collaborators_url": "https://api.github.com/repos/octocat/Spoon-Knife/collaborators{/collaborator}",
                                                                                                                  "teams_url": "https://api.github.com/repos/octocat/Spoon-Knife/teams",
                                                                                                                  "hooks_url": "https://api.github.com/repos/octocat/Spoon-Knife/hooks",
                                                                                                                  "issue_events_url": "https://api.github.com/repos/octocat/Spoon-Knife/issues/events{/number}",
                                                                                                                  "events_url": "https://api.github.com/repos/octocat/Spoon-Knife/events",
                                                                                                                  "assignees_url": "https://api.github.com/repos/octocat/Spoon-Knife/assignees{/user}",
                                                                                                                  "branches_url": "https://api.github.com/repos/octocat/Spoon-Knife/branches{/branch}",
                                                                                                                  "tags_url": "https://api.github.com/repos/octocat/Spoon-Knife/tags",
                                                                                                                  "blobs_url": "https://api.github.com/repos/octocat/Spoon-Knife/git/blobs{/sha}",
                                                                                                                  "git_tags_url": "https://api.github.com/repos/octocat/Spoon-Knife/git/tags{/sha}",
                                                                                                                  "git_refs_url": "https://api.github.com/repos/octocat/Spoon-Knife/git/refs{/sha}",
                                                                                                                  "trees_url": "https://api.github.com/repos/octocat/Spoon-Knife/git/trees{/sha}",
                                                                                                                  "statuses_url": "https://api.github.com/repos/octocat/Spoon-Knife/statuses/{sha}",
                                                                                                                  "languages_url": "https://api.github.com/repos/octocat/Spoon-Knife/languages",
                                                                                                                  "stargazers_url": "https://api.github.com/repos/octocat/Spoon-Knife/stargazers",
                                                                                                                  "contributors_url": "https://api.github.com/repos/octocat/Spoon-Knife/contributors",
                                                                                                                  "subscribers_url": "https://api.github.com/repos/octocat/Spoon-Knife/subscribers",
                                                                                                                  "subscription_url": "https://api.github.com/repos/octocat/Spoon-Knife/subscription",
                                                                                                                  "commits_url": "https://api.github.com/repos/octocat/Spoon-Knife/commits{/sha}",
                                                                                                                  "git_commits_url": "https://api.github.com/repos/octocat/Spoon-Knife/git/commits{/sha}",
                                                                                                                  "comments_url": "https://api.github.com/repos/octocat/Spoon-Knife/comments{/number}",
                                                                                                                  "issue_comment_url": "https://api.github.com/repos/octocat/Spoon-Knife/issues/comments{/number}",
                                                                                                                  "contents_url": "https://api.github.com/repos/octocat/Spoon-Knife/contents/{+path}",
                                                                                                                  "compare_url": "https://api.github.com/repos/octocat/Spoon-Knife/compare/{base}...{head}",
                                                                                                                  "merges_url": "https://api.github.com/repos/octocat/Spoon-Knife/merges",
                                                                                                                  "archive_url": "https://api.github.com/repos/octocat/Spoon-Knife/{archive_format}{/ref}",
                                                                                                                  "downloads_url": "https://api.github.com/repos/octocat/Spoon-Knife/downloads",
                                                                                                                  "issues_url": "https://api.github.com/repos/octocat/Spoon-Knife/issues{/number}",
                                                                                                                  "pulls_url": "https://api.github.com/repos/octocat/Spoon-Knife/pulls{/number}",
                                                                                                                  "milestones_url": "https://api.github.com/repos/octocat/Spoon-Knife/milestones{/number}",
                                                                                                                  "notifications_url": "https://api.github.com/repos/octocat/Spoon-Knife/notifications{?since,all,participating}",
                                                                                                                  "labels_url": "https://api.github.com/repos/octocat/Spoon-Knife/labels{/name}",
                                                                                                                  "releases_url": "https://api.github.com/repos/octocat/Spoon-Knife/releases{/id}",
                                                                                                                  "deployments_url": "https://api.github.com/repos/octocat/Spoon-Knife/deployments"
                                                                                                                },
                                                                                                                "score": 4.9971514
                                                                                                              }
                                                                                                            ]
                                                                                                          }
                                                                                                          

                                                                                                          Highlighting Code Search Results

                                                                                                          When searching for commits, you can get text match metadata for the message field. (See the section on text match metadata for full details.)

                                                                                                          Search code

                                                                                                          Find file contents via various criteria. This method returns up to 100 results per page.

                                                                                                          GET /search/code
                                                                                                          

                                                                                                          Note: You must authenticate to search for code across all public repositories.

                                                                                                          Considerations for code search

                                                                                                          Due to the complexity of searching code, there are a few restrictions on how searches are performed:

                                                                                                          • Only the default branch is considered. In most cases, this will be the master branch.
                                                                                                          • Only files smaller than 384 KB are searchable.
                                                                                                          • You must always include at least one search term when searching source code. For example, searching for language:go is not valid, while amazing language:go is.

                                                                                                          Parameters

                                                                                                          Name Type Description
                                                                                                          q string The search terms.
                                                                                                          sort string The sort field. Can only be indexed, which indicates how recently a file has been indexed by the GitHub search infrastructure. Default: results are sorted by best match.
                                                                                                          order string The sort order if sort parameter is provided. One of asc or desc. Default: desc

                                                                                                          The q search term can also contain any combination of the supported code search qualifiers as described by the in-browser code search documentation and search syntax documentation:

                                                                                                          • in Qualifies which fields are searched. With this qualifier you can restrict the search to the file contents (file), the file path (path), or both.
                                                                                                          • language Searches code based on the language it's written in.
                                                                                                          • fork Specifies that code from forked repositories should be searched (true). Repository forks will not be searchable unless the fork has more stars than the parent repository.
                                                                                                          • size Finds files that match a certain size (in bytes).
                                                                                                          • path Specifies the path prefix that the resulting file must be under.
                                                                                                          • filename Matches files by a substring of the filename.
                                                                                                          • extension Matches files with a certain extension after a dot.
                                                                                                          • user or repo Limits searches to a specific user or repository.

                                                                                                          Example

                                                                                                          Suppose you want to find the definition of the addClass function inside jQuery. Your query would look something like this:

                                                                                                          https://api.github.com/search/code?q=addClass+in:file+language:js+repo:jquery/jquery
                                                                                                          

                                                                                                          Here, we're searching for the keyword addClass within a file's contents. We're making sure that we're only looking in files where the language is JavaScript. And we're scoping the search to the repo:jquery/jquery repository.

                                                                                                          Status: 200 OK
                                                                                                          Link: <https://api.github.com/resource?page=2>; rel="next",
                                                                                                                <https://api.github.com/resource?page=5>; rel="last"
                                                                                                          X-RateLimit-Limit: 20
                                                                                                          X-RateLimit-Remaining: 19
                                                                                                          
                                                                                                          {
                                                                                                            "total_count": 7,
                                                                                                            "incomplete_results": false,
                                                                                                            "items": [
                                                                                                              {
                                                                                                                "name": "classes.js",
                                                                                                                "path": "src/attributes/classes.js",
                                                                                                                "sha": "d7212f9dee2dcc18f084d7df8f417b80846ded5a",
                                                                                                                "url": "https://api.github.com/repositories/167174/contents/src/attributes/classes.js?ref=825ac3773694e0cd23ee74895fd5aeb535b27da4",
                                                                                                                "git_url": "https://api.github.com/repositories/167174/git/blobs/d7212f9dee2dcc18f084d7df8f417b80846ded5a",
                                                                                                                "html_url": "https://github.com/jquery/jquery/blob/825ac3773694e0cd23ee74895fd5aeb535b27da4/src/attributes/classes.js",
                                                                                                                "repository": {
                                                                                                                  "id": 167174,
                                                                                                                  "name": "jquery",
                                                                                                                  "full_name": "jquery/jquery",
                                                                                                                  "owner": {
                                                                                                                    "login": "jquery",
                                                                                                                    "id": 70142,
                                                                                                                    "avatar_url": "https://0.gravatar.com/avatar/6906f317a4733f4379b06c32229ef02f?d=https%3A%2F%2Fidenticons.github.com%2Ff426f04f2f9813718fb806b30e0093de.png",
                                                                                                                    "gravatar_id": "",
                                                                                                                    "url": "https://api.github.com/users/jquery",
                                                                                                                    "html_url": "https://github.com/jquery",
                                                                                                                    "followers_url": "https://api.github.com/users/jquery/followers",
                                                                                                                    "following_url": "https://api.github.com/users/jquery/following{/other_user}",
                                                                                                                    "gists_url": "https://api.github.com/users/jquery/gists{/gist_id}",
                                                                                                                    "starred_url": "https://api.github.com/users/jquery/starred{/owner}{/repo}",
                                                                                                                    "subscriptions_url": "https://api.github.com/users/jquery/subscriptions",
                                                                                                                    "organizations_url": "https://api.github.com/users/jquery/orgs",
                                                                                                                    "repos_url": "https://api.github.com/users/jquery/repos",
                                                                                                                    "events_url": "https://api.github.com/users/jquery/events{/privacy}",
                                                                                                                    "received_events_url": "https://api.github.com/users/jquery/received_events",
                                                                                                                    "type": "Organization",
                                                                                                                    "site_admin": false
                                                                                                                  },
                                                                                                                  "private": false,
                                                                                                                  "html_url": "https://github.com/jquery/jquery",
                                                                                                                  "description": "jQuery JavaScript Library",
                                                                                                                  "fork": false,
                                                                                                                  "url": "https://api.github.com/repos/jquery/jquery",
                                                                                                                  "forks_url": "https://api.github.com/repos/jquery/jquery/forks",
                                                                                                                  "keys_url": "https://api.github.com/repos/jquery/jquery/keys{/key_id}",
                                                                                                                  "collaborators_url": "https://api.github.com/repos/jquery/jquery/collaborators{/collaborator}",
                                                                                                                  "teams_url": "https://api.github.com/repos/jquery/jquery/teams",
                                                                                                                  "hooks_url": "https://api.github.com/repos/jquery/jquery/hooks",
                                                                                                                  "issue_events_url": "https://api.github.com/repos/jquery/jquery/issues/events{/number}",
                                                                                                                  "events_url": "https://api.github.com/repos/jquery/jquery/events",
                                                                                                                  "assignees_url": "https://api.github.com/repos/jquery/jquery/assignees{/user}",
                                                                                                                  "branches_url": "https://api.github.com/repos/jquery/jquery/branches{/branch}",
                                                                                                                  "tags_url": "https://api.github.com/repos/jquery/jquery/tags",
                                                                                                                  "blobs_url": "https://api.github.com/repos/jquery/jquery/git/blobs{/sha}",
                                                                                                                  "git_tags_url": "https://api.github.com/repos/jquery/jquery/git/tags{/sha}",
                                                                                                                  "git_refs_url": "https://api.github.com/repos/jquery/jquery/git/refs{/sha}",
                                                                                                                  "trees_url": "https://api.github.com/repos/jquery/jquery/git/trees{/sha}",
                                                                                                                  "statuses_url": "https://api.github.com/repos/jquery/jquery/statuses/{sha}",
                                                                                                                  "languages_url": "https://api.github.com/repos/jquery/jquery/languages",
                                                                                                                  "stargazers_url": "https://api.github.com/repos/jquery/jquery/stargazers",
                                                                                                                  "contributors_url": "https://api.github.com/repos/jquery/jquery/contributors",
                                                                                                                  "subscribers_url": "https://api.github.com/repos/jquery/jquery/subscribers",
                                                                                                                  "subscription_url": "https://api.github.com/repos/jquery/jquery/subscription",
                                                                                                                  "commits_url": "https://api.github.com/repos/jquery/jquery/commits{/sha}",
                                                                                                                  "git_commits_url": "https://api.github.com/repos/jquery/jquery/git/commits{/sha}",
                                                                                                                  "comments_url": "https://api.github.com/repos/jquery/jquery/comments{/number}",
                                                                                                                  "issue_comment_url": "https://api.github.com/repos/jquery/jquery/issues/comments/{number}",
                                                                                                                  "contents_url": "https://api.github.com/repos/jquery/jquery/contents/{+path}",
                                                                                                                  "compare_url": "https://api.github.com/repos/jquery/jquery/compare/{base}...{head}",
                                                                                                                  "merges_url": "https://api.github.com/repos/jquery/jquery/merges",
                                                                                                                  "archive_url": "https://api.github.com/repos/jquery/jquery/{archive_format}{/ref}",
                                                                                                                  "downloads_url": "https://api.github.com/repos/jquery/jquery/downloads",
                                                                                                                  "issues_url": "https://api.github.com/repos/jquery/jquery/issues{/number}",
                                                                                                                  "pulls_url": "https://api.github.com/repos/jquery/jquery/pulls{/number}",
                                                                                                                  "milestones_url": "https://api.github.com/repos/jquery/jquery/milestones{/number}",
                                                                                                                  "notifications_url": "https://api.github.com/repos/jquery/jquery/notifications{?since,all,participating}",
                                                                                                                  "labels_url": "https://api.github.com/repos/jquery/jquery/labels{/name}"
                                                                                                                },
                                                                                                                "score": 0.5269679
                                                                                                              }
                                                                                                            ]
                                                                                                          }
                                                                                                          

                                                                                                          Highlighting Code Search Results

                                                                                                          Some API consumers will want to highlight the matching search terms when displaying search results. The API offers additional metadata to support this use case. To get this metadata in your search results, specify the text-match media type in your Accept header. For example, via curl, the above query would look like this:

                                                                                                          curl -H 'Accept: application/vnd.github.v3.text-match+json' \
                                                                                                            https://api.github.com/search/code?q=addClass+in:file+language:js+repo:jquery/jquery
                                                                                                          

                                                                                                          This produces the same JSON payload as above, with an extra key called text_matches, an array of objects. These objects provide information such as the position of your search terms within the text, as well as the property that included the search term.

                                                                                                          When searching for code, you can get text match metadata for the file content and file path fields. (See the section on text match metadata for full details.)

                                                                                                          Here's an example response:

                                                                                                          {
                                                                                                            "text_matches": [
                                                                                                              {
                                                                                                                "object_url": "https://api.github.com/repositories/167174/contents/src/attributes/classes.js?ref=825ac3773694e0cd23ee74895fd5aeb535b27da4",
                                                                                                                "object_type": "FileContent",
                                                                                                                "property": "content",
                                                                                                                "fragment": ";\n\njQuery.fn.extend({\n\taddClass: function( value ) {\n\t\tvar classes, elem, cur, clazz, j, finalValue",
                                                                                                                "matches": [
                                                                                                                  {
                                                                                                                    "text": "addClass",
                                                                                                                    "indices": [
                                                                                                                      23,
                                                                                                                      31
                                                                                                                    ]
                                                                                                                  }
                                                                                                                ]
                                                                                                              },
                                                                                                              {
                                                                                                                "object_url": "https://api.github.com/repositories/167174/contents/src/attributes/classes.js?ref=825ac3773694e0cd23ee74895fd5aeb535b27da4",
                                                                                                                "object_type": "FileContent",
                                                                                                                "property": "content",
                                                                                                                "fragment": ".isFunction( value ) ) {\n\t\t\treturn this.each(function( j ) {\n\t\t\t\tjQuery( this ).addClass( value.call( this",
                                                                                                                "matches": [
                                                                                                                  {
                                                                                                                    "text": "addClass",
                                                                                                                    "indices": [
                                                                                                                      80,
                                                                                                                      88
                                                                                                                    ]
                                                                                                                  }
                                                                                                                ]
                                                                                                              }
                                                                                                            ]
                                                                                                          }
                                                                                                          

                                                                                                          Search issues

                                                                                                          Find issues by state and keyword. This method returns up to 100 results per page.

                                                                                                          GET /search/issues
                                                                                                          

                                                                                                          Parameters

                                                                                                          Name Type Description
                                                                                                          q string The search terms.
                                                                                                          sort string The sort field. Can be comments, created, or updated. Default: results are sorted by best match.
                                                                                                          order string The sort order if sort parameter is provided. One of asc or desc. Default: desc

                                                                                                          The q search term can also contain any combination of the supported issue search qualifiers as described by the in-browser issue search documentation and search syntax documentation:

                                                                                                          • type With this qualifier you can restrict the search to issues (issue) or pull request (pr) only.
                                                                                                          • in Qualifies which fields are searched. With this qualifier you can restrict the search to just the title (title), body (body), comments (comments), or any combination of these.
                                                                                                          • author Finds issues or pull requests created by a certain user.
                                                                                                          • assignee Finds issues or pull requests that are assigned to a certain user.
                                                                                                          • mentions Finds issues or pull requests that mention a certain user.
                                                                                                          • commenter Finds issues or pull requests that a certain user commented on.
                                                                                                          • involves Finds issues or pull requests that were either created by a certain user, assigned to that user, mention that user, or were commented on by that user.
                                                                                                          • team For organizations you're a member of, finds issues or pull requests that @mention a team within the organization.
                                                                                                          • state Filter issues or pull requests based on whether they're open or closed.
                                                                                                          • labels Filters issues or pull requests based on their labels.
                                                                                                          • no Filters items missing certain metadata, such as label, milestone, or assignee
                                                                                                          • language Searches for issues or pull requests within repositories that match a certain language.
                                                                                                          • is Searches for items within repositories that match a certain state, such as open, closed, or merged
                                                                                                          • created or updated Filters issues or pull requests based on date of creation, or when they were last updated.
                                                                                                          • merged Filters pull requests based on the date when they were merged.
                                                                                                          • status Filters pull requests based on the commit status.
                                                                                                          • head or base Filters pull requests based on the branch that they came from or that they are modifying.
                                                                                                          • closed Filters issues or pull requests based on the date when they were closed.
                                                                                                          • comments Filters issues or pull requests based on the quantity of comments.
                                                                                                          • user or repo Limits searches to a specific user or repository.
                                                                                                          • project Limits searches to a specific project board in a repository or organization.
                                                                                                          • archived Filters issues or pull requests based on whether they are in an archived repository.

                                                                                                          If you know the specific SHA hash of a commit, you can use also use it to search for pull requests that contain that SHA. Note that the SHA syntax must be at least seven characters.

                                                                                                          Example

                                                                                                          Let's say you want to find the oldest unresolved Python bugs on Windows. Your query might look something like this.

                                                                                                          https://api.github.com/search/issues?q=windows+label:bug+language:python+state:open&sort=created&order=asc
                                                                                                          

                                                                                                          In this query, we're searching for the keyword windows, within any open issue that's labeled as bug. The search runs across repositories whose primary language is Python. We’re sorting by creation date in ascending order, so that the oldest issues appear first in the search results.

                                                                                                          Status: 200 OK
                                                                                                          Link: <https://api.github.com/resource?page=2>; rel="next",
                                                                                                                <https://api.github.com/resource?page=5>; rel="last"
                                                                                                          X-RateLimit-Limit: 20
                                                                                                          X-RateLimit-Remaining: 19
                                                                                                          
                                                                                                          {
                                                                                                            "total_count": 280,
                                                                                                            "incomplete_results": false,
                                                                                                            "items": [
                                                                                                              {
                                                                                                                "url": "https://api.github.com/repos/batterseapower/pinyin-toolkit/issues/132",
                                                                                                                "repository_url": "https://api.github.com/repos/batterseapower/pinyin-toolkit",
                                                                                                                "labels_url": "https://api.github.com/repos/batterseapower/pinyin-toolkit/issues/132/labels{/name}",
                                                                                                                "comments_url": "https://api.github.com/repos/batterseapower/pinyin-toolkit/issues/132/comments",
                                                                                                                "events_url": "https://api.github.com/repos/batterseapower/pinyin-toolkit/issues/132/events",
                                                                                                                "html_url": "https://github.com/batterseapower/pinyin-toolkit/issues/132",
                                                                                                                "id": 35802,
                                                                                                                "number": 132,
                                                                                                                "title": "Line Number Indexes Beyond 20 Not Displayed",
                                                                                                                "user": {
                                                                                                                  "login": "Nick3C",
                                                                                                                  "id": 90254,
                                                                                                                  "avatar_url": "https://secure.gravatar.com/avatar/934442aadfe3b2f4630510de416c5718?d=https://a248.e.akamai.net/assets.github.com%2Fimages%2Fgravatars%2Fgravatar-user-420.png",
                                                                                                                  "gravatar_id": "",
                                                                                                                  "url": "https://api.github.com/users/Nick3C",
                                                                                                                  "html_url": "https://github.com/Nick3C",
                                                                                                                  "followers_url": "https://api.github.com/users/Nick3C/followers",
                                                                                                                  "following_url": "https://api.github.com/users/Nick3C/following{/other_user}",
                                                                                                                  "gists_url": "https://api.github.com/users/Nick3C/gists{/gist_id}",
                                                                                                                  "starred_url": "https://api.github.com/users/Nick3C/starred{/owner}{/repo}",
                                                                                                                  "subscriptions_url": "https://api.github.com/users/Nick3C/subscriptions",
                                                                                                                  "organizations_url": "https://api.github.com/users/Nick3C/orgs",
                                                                                                                  "repos_url": "https://api.github.com/users/Nick3C/repos",
                                                                                                                  "events_url": "https://api.github.com/users/Nick3C/events{/privacy}",
                                                                                                                  "received_events_url": "https://api.github.com/users/Nick3C/received_events",
                                                                                                                  "type": "User"
                                                                                                                },
                                                                                                                "labels": [
                                                                                                                  {
                                                                                                                    "url": "https://api.github.com/repos/batterseapower/pinyin-toolkit/labels/bug",
                                                                                                                    "name": "bug",
                                                                                                                    "color": "ff0000"
                                                                                                                  }
                                                                                                                ],
                                                                                                                "state": "open",
                                                                                                                "assignee": null,
                                                                                                                "milestone": null,
                                                                                                                "comments": 15,
                                                                                                                "created_at": "2009-07-12T20:10:41Z",
                                                                                                                "updated_at": "2009-07-19T09:23:43Z",
                                                                                                                "closed_at": null,
                                                                                                                "pull_request": {
                                                                                                                  "html_url": null,
                                                                                                                  "diff_url": null,
                                                                                                                  "patch_url": null
                                                                                                                },
                                                                                                                "body": "...",
                                                                                                                "score": 1.3859273
                                                                                                              }
                                                                                                            ]
                                                                                                          }
                                                                                                          

                                                                                                          Highlighting Issue Search Results

                                                                                                          Some API consumers will want to highlight the matching search terms when displaying search results. The API offers additional metadata to support this use case. To get this metadata in your search results, specify the text-match media type in your Accept header. For example, via curl, the above query would look like this:

                                                                                                          curl -H 'Accept: application/vnd.github.v3.text-match+json' \
                                                                                                            'https://api.github.com/search/issues?q=windows+label:bug+language:python+state:open&sort=created&order=asc'
                                                                                                          

                                                                                                          This produces the same JSON payload as above, with an extra key called text_matches, an array of objects. These objects provide information such as the position of your search terms within the text, as well as the property that included the search term.

                                                                                                          When searching for issues, you can get text match metadata for the issue title, issue body, and issue comment body fields. (See the section on text match metadata for full details.)

                                                                                                          Here's an example response:

                                                                                                          {
                                                                                                            "text_matches": [
                                                                                                              {
                                                                                                                "object_url": "https://api.github.com/repositories/215335/issues/132",
                                                                                                                "object_type": "Issue",
                                                                                                                "property": "body",
                                                                                                                "fragment": "comprehensive windows font I know of).\n\nIf we can find a commonly distributed windows font that supports them then no problem (we can use html font tags) but otherwise the '(21)' style is probably better.\n",
                                                                                                                "matches": [
                                                                                                                  {
                                                                                                                    "text": "windows",
                                                                                                                    "indices": [
                                                                                                                      14,
                                                                                                                      21
                                                                                                                    ]
                                                                                                                  },
                                                                                                                  {
                                                                                                                    "text": "windows",
                                                                                                                    "indices": [
                                                                                                                      78,
                                                                                                                      85
                                                                                                                    ]
                                                                                                                  }
                                                                                                                ]
                                                                                                              },
                                                                                                              {
                                                                                                                "object_url": "https://api.github.com/repositories/215335/issues/comments/25688",
                                                                                                                "object_type": "IssueComment",
                                                                                                                "property": "body",
                                                                                                                "fragment": " right after that are a bit broken IMHO :). I suppose we could have some hack that maxes out at whatever the font does...\n\nI'll check what the state of play is on Windows.\n",
                                                                                                                "matches": [
                                                                                                                  {
                                                                                                                    "text": "Windows",
                                                                                                                    "indices": [
                                                                                                                      163,
                                                                                                                      170
                                                                                                                    ]
                                                                                                                  }
                                                                                                                ]
                                                                                                              }
                                                                                                            ]
                                                                                                          }
                                                                                                          

                                                                                                          Search users

                                                                                                          Find users via various criteria. This method returns up to 100 results per page.

                                                                                                          GET /search/users
                                                                                                          

                                                                                                          Parameters

                                                                                                          Name Type Description
                                                                                                          q string The search terms.
                                                                                                          sort string The sort field. Can be followers, repositories, or joined. Default: results are sorted by best match.
                                                                                                          order string The sort order if sort parameter is provided. One of asc or desc. Default: desc

                                                                                                          The q search term can also contain any combination of the supported user search qualifiers as described by the in-browser user search documentation and search syntax documentation:

                                                                                                          • type With this qualifier you can restrict the search to just personal accounts (user) or just organization accounts (org).
                                                                                                          • in Qualifies which fields are searched. With this qualifier you can restrict the search to just the username (login), public email (email), full name (fullname), or any combination of these.
                                                                                                          • repos Filters users based on the number of repositories they have.
                                                                                                          • location Filter users by the location indicated in their profile.
                                                                                                          • language Search for users that have repositories that match a certain language.
                                                                                                          • created Filter users based on when they joined.
                                                                                                          • followers Filter users based on the number of followers they have.

                                                                                                          Example

                                                                                                          Imagine you're looking for a list of popular users. You might try out this query:

                                                                                                          https://api.github.com/search/users?q=tom+repos:%3E42+followers:%3E1000
                                                                                                          

                                                                                                          Here, we're looking at users with the name Tom. We're only interested in those with more than 42 repositories, and only if they have over 1,000 followers.

                                                                                                          Status: 200 OK
                                                                                                          Link: <https://api.github.com/resource?page=2>; rel="next",
                                                                                                                <https://api.github.com/resource?page=5>; rel="last"
                                                                                                          X-RateLimit-Limit: 20
                                                                                                          X-RateLimit-Remaining: 19
                                                                                                          
                                                                                                          {
                                                                                                            "total_count": 12,
                                                                                                            "incomplete_results": false,
                                                                                                            "items": [
                                                                                                              {
                                                                                                                "login": "mojombo",
                                                                                                                "id": 1,
                                                                                                                "avatar_url": "https://secure.gravatar.com/avatar/25c7c18223fb42a4c6ae1c8db6f50f9b?d=https://a248.e.akamai.net/assets.github.com%2Fimages%2Fgravatars%2Fgravatar-user-420.png",
                                                                                                                "gravatar_id": "",
                                                                                                                "url": "https://api.github.com/users/mojombo",
                                                                                                                "html_url": "https://github.com/mojombo",
                                                                                                                "followers_url": "https://api.github.com/users/mojombo/followers",
                                                                                                                "subscriptions_url": "https://api.github.com/users/mojombo/subscriptions",
                                                                                                                "organizations_url": "https://api.github.com/users/mojombo/orgs",
                                                                                                                "repos_url": "https://api.github.com/users/mojombo/repos",
                                                                                                                "received_events_url": "https://api.github.com/users/mojombo/received_events",
                                                                                                                "type": "User",
                                                                                                                "score": 105.47857
                                                                                                              }
                                                                                                            ]
                                                                                                          }
                                                                                                          

                                                                                                          Highlighting User Search Results

                                                                                                          Some API consumers will want to highlight the matching search terms when displaying search results. The API offers additional metadata to support this use case. To get this metadata in your search results, specify the text-match media type in your Accept header. For example, via curl, the above query would look like this:

                                                                                                          curl -H 'Accept: application/vnd.github.v3.text-match+json' \
                                                                                                            https://api.github.com/search/users?q=tom+repos:%3E42+followers:%3E1000
                                                                                                          

                                                                                                          This produces the same JSON payload as above, with an extra key called text_matches, an array of objects. These objects provide information such as the position of your search terms within the text, as well as the property that included the search term.

                                                                                                          When searching for users, you can get text match metadata for the issue login, email, and name fields. (See the section on text match metadata for full details.)

                                                                                                          {
                                                                                                            "text_matches": [
                                                                                                              {
                                                                                                                "object_url": "https://api.github.com/users/mojombo",
                                                                                                                "object_type": "User",
                                                                                                                "property": "email",
                                                                                                                "fragment": "tom@github.com",
                                                                                                                "matches": [
                                                                                                                  {
                                                                                                                    "text": "tom",
                                                                                                                    "indices": [
                                                                                                                      0,
                                                                                                                      3
                                                                                                                    ]
                                                                                                                  }
                                                                                                                ]
                                                                                                              },
                                                                                                              {
                                                                                                                "object_url": "https://api.github.com/users/mojombo",
                                                                                                                "object_type": "User",
                                                                                                                "property": "name",
                                                                                                                "fragment": "Tom Preston-Werner",
                                                                                                                "matches": [
                                                                                                                  {
                                                                                                                    "text": "Tom",
                                                                                                                    "indices": [
                                                                                                                      0,
                                                                                                                      3
                                                                                                                    ]
                                                                                                                  }
                                                                                                                ]
                                                                                                              }
                                                                                                            ]
                                                                                                          }
                                                                                                          

                                                                                                          Search topics

                                                                                                          Note: The topics property for repositories on GitHub is currently available for developers to preview. To view the topics property in calls that return repository results, you must provide a custom media type in the Accept header:

                                                                                                          application/vnd.github.mercy-preview+json
                                                                                                          

                                                                                                          Find topics via various criteria. This method returns up to 100 results per page.

                                                                                                          GET /search/topics
                                                                                                          

                                                                                                          Parameters

                                                                                                          Name Type Description
                                                                                                          q string The search terms.

                                                                                                          Results are sorted by best match by default.

                                                                                                          The q search term can also contain any combination of the supported topic search qualifiers as described by the in-browser topic search documentation and search syntax documentation:

                                                                                                          • is:curated Finds topics that have extra information, e.g., a description, display name, or logo, because they have an entry in the github/explore repository.
                                                                                                          • is:featured Finds topics listed on https://github.com/topics. Any featured topic will also be curated.
                                                                                                          • is:not-featured Finds topics not listed on https://github.com/topics.
                                                                                                          • is:not-curated Finds topics that have no extra information because they haven't been added to the github/explore repository.
                                                                                                          • repositories: Finds topics with some number of repositories using them, e.g., repositories:>1000.

                                                                                                          Example

                                                                                                          Suppose you want to search for topics related to Ruby that are featured on https://github.com/topics. Your query might look like this:

                                                                                                          curl -H 'Accept: application/vnd.github.mercy-preview+json' \
                                                                                                            'https://api.github.com/search/topics?q=ruby+is:featured'
                                                                                                          

                                                                                                          In this request, we're searching for topics with the keyword ruby, and we're limiting the results to find only topics that are featured. The topics that are the best match for the query appear first in the search results.

                                                                                                          Note: A search for featured Ruby topics only has 5 total results, so a Link header indicating pagination is not included in the response.

                                                                                                          Status: 200 OK
                                                                                                          X-RateLimit-Limit: 20
                                                                                                          X-RateLimit-Remaining: 19
                                                                                                          
                                                                                                          {
                                                                                                            "total_count": 5,
                                                                                                            "incomplete_results": false,
                                                                                                            "items": [
                                                                                                              {
                                                                                                                "name": "python",
                                                                                                                "display_name": "Python",
                                                                                                                "short_description": "Python is a dynamically typed programming language.",
                                                                                                                "description": "Python is a dynamically typed programming language designed by Guido Van Rossum. Much like the programming language Ruby, Python was designed to be easily read by programmers. Because of its large following and many libraries, Python can be implemented and used to do anything from webpages to scientific research.",
                                                                                                                "created_by": "Guido van Rossum",
                                                                                                                "released": "February 20, 1991",
                                                                                                                "created_at": "2016-12-07T00:07:02Z",
                                                                                                                "updated_at": "2017-10-27T22:45:43Z",
                                                                                                                "featured": true,
                                                                                                                "curated": true,
                                                                                                                "score": 110.53404
                                                                                                              },
                                                                                                              {
                                                                                                                "name": "ruby",
                                                                                                                "display_name": "Ruby",
                                                                                                                "short_description": "Ruby is a scripting language designed for simplified object-oriented programming.",
                                                                                                                "description": "Ruby was developed by Yukihiro \"Matz\" Matsumoto in 1995 with the intent of having an easily readable programming language. It is integrated with the Rails framework to create dynamic web-applications. Ruby's syntax is similar to that of Perl and Python.",
                                                                                                                "created_by": "Yukihiro Matsumoto",
                                                                                                                "released": "December 21, 1995",
                                                                                                                "created_at": "2016-11-28T22:03:59Z",
                                                                                                                "updated_at": "2017-10-30T18:16:32Z",
                                                                                                                "featured": true,
                                                                                                                "curated": true,
                                                                                                                "score": 1654.4354
                                                                                                              },
                                                                                                              {
                                                                                                                "name": "rails",
                                                                                                                "display_name": "Rails",
                                                                                                                "short_description": "Ruby on Rails (Rails) is a web application framework written in Ruby.",
                                                                                                                "description": "Ruby on Rails (Rails) is a web application framework written in Ruby. It is meant to help simplify the building of complex websites.",
                                                                                                                "created_by": "David Heinemeier Hansson",
                                                                                                                "released": "December 13 2005",
                                                                                                                "created_at": "2016-12-09T17:03:50Z",
                                                                                                                "updated_at": "2017-10-30T16:20:19Z",
                                                                                                                "featured": true,
                                                                                                                "curated": true,
                                                                                                                "score": 184.66095
                                                                                                              },
                                                                                                              {
                                                                                                                "name": "sass",
                                                                                                                "display_name": "Sass",
                                                                                                                "short_description": "Sass is a stable extension to classic CSS.",
                                                                                                                "description": "Sass is a stylesheet language with a main implementation in Ruby. It is an extension of CSS that makes improvements to the old stylesheet format, such as being able to declare variables and using a cleaner nesting syntax.",
                                                                                                                "created_by": "Hampton Catlin, Natalie Weizenbaum, Chris Eppstein",
                                                                                                                "released": "November 28, 2006",
                                                                                                                "created_at": "2016-12-16T21:53:45Z",
                                                                                                                "updated_at": "2018-01-16T16:30:40Z",
                                                                                                                "featured": true,
                                                                                                                "curated": true,
                                                                                                                "score": 42.08008
                                                                                                              },
                                                                                                              {
                                                                                                                "name": "jekyll",
                                                                                                                "display_name": "Jekyll",
                                                                                                                "short_description": "Jekyll is a simple, blog-aware static site generator.",
                                                                                                                "description": "Jekyll is a blog-aware, site generator written in Ruby. It takes raw text files, runs it through a renderer and produces a publishable static website.",
                                                                                                                "created_by": "Tom Preston-Werner",
                                                                                                                "released": "2008",
                                                                                                                "created_at": "2016-12-16T21:53:08Z",
                                                                                                                "updated_at": "2017-10-27T19:00:24Z",
                                                                                                                "featured": true,
                                                                                                                "curated": true,
                                                                                                                "score": 44.98746
                                                                                                              }
                                                                                                            ]
                                                                                                          }
                                                                                                          

                                                                                                          Text match metadata

                                                                                                          On github.com, we enjoy the context provided by code snippets and highlights in search results.

                                                                                                          code-snippet-highlighting

                                                                                                          API consumers have access to that information as well. Requests can opt to receive those text fragments in the response, and every fragment is accompanied by numeric offsets identifying the exact location of each matching search term.

                                                                                                          To get this metadata in your search results, specify the text-match media type in your Accept header.

                                                                                                          application/vnd.github.v3.text-match+json
                                                                                                          

                                                                                                          The results will provide the same JSON payloads as shown above, with an extra key called text_matches. Inside the text_matches array, each object includes the following attributes:

                                                                                                          Name Description
                                                                                                          object_url The URL for the resource that contains a string property matching one of the search terms.
                                                                                                          object_type The name for the type of resource that exists at the given object_url.
                                                                                                          property The name of a property of the resource that exists at object_url. That property is a string that matches one of the search terms. (In the JSON returned from object_url, the full content for the fragment will be found in the property with this name.)
                                                                                                          fragment A subset of the value of property. This is the text fragment that matches one or more of the search terms.
                                                                                                          matches An array of one or more search terms that are present in fragment. The indices (i.e., "offsets") are relative to the fragment. (They are not relative to the full content of property.)

                                                                                                          Example

                                                                                                          Using curl, and the example issue search above, our API request would look like this:

                                                                                                          curl -H 'Accept: application/vnd.github.v3.text-match+json' \
                                                                                                            'https://api.github.com/search/issues?q=windows+label:bug+language:python+state:open&sort=created&order=asc'
                                                                                                          

                                                                                                          The response will include a text_matches array for each search result. In the JSON below, we have two objects in the text_matches array.

                                                                                                          The first text match occurred in the body property of the issue. We see a fragment of text from the issue body. The search term (windows) appears twice within that fragment, and we have the indices for each occurrence.

                                                                                                          The second text match occurred in the body property of one of the issue's comments. We have the URL for the issue comment. And of course, we see a fragment of text from the comment body. The search term (windows) appears once within that fragment.

                                                                                                          {
                                                                                                            "text_matches": [
                                                                                                              {
                                                                                                                "object_url": "https://api.github.com/repositories/215335/issues/132",
                                                                                                                "object_type": "Issue",
                                                                                                                "property": "body",
                                                                                                                "fragment": "comprehensive windows font I know of).\n\nIf we can find a commonly distributed windows font that supports them then no problem (we can use html font tags) but otherwise the '(21)' style is probably better.\n",
                                                                                                                "matches": [
                                                                                                                  {
                                                                                                                    "text": "windows",
                                                                                                                    "indices": [
                                                                                                                      14,
                                                                                                                      21
                                                                                                                    ]
                                                                                                                  },
                                                                                                                  {
                                                                                                                    "text": "windows",
                                                                                                                    "indices": [
                                                                                                                      78,
                                                                                                                      85
                                                                                                                    ]
                                                                                                                  }
                                                                                                                ]
                                                                                                              },
                                                                                                              {
                                                                                                                "object_url": "https://api.github.com/repositories/215335/issues/comments/25688",
                                                                                                                "object_type": "IssueComment",
                                                                                                                "property": "body",
                                                                                                                "fragment": " right after that are a bit broken IMHO :). I suppose we could have some hack that maxes out at whatever the font does...\n\nI'll check what the state of play is on Windows.\n",
                                                                                                                "matches": [
                                                                                                                  {
                                                                                                                    "text": "Windows",
                                                                                                                    "indices": [
                                                                                                                      163,
                                                                                                                      170
                                                                                                                    ]
                                                                                                                  }
                                                                                                                ]
                                                                                                              }
                                                                                                            ]
                                                                                                          }
                                                                                                          
                                                                                                          tmp/developer.github.com/v3/search/legacy/index.html Legacy Search | GitHub Developer Guide

                                                                                                          Legacy Search

                                                                                                          This is a listing of the Legacy Search API features from API v2 that have been ported to API v3. There should be no changes, other than the new URL and JSON output format.

                                                                                                          Legacy Search API is Deprecated

                                                                                                          The Legacy Search API (described below) is deprecated. We recommend using the v3 Search API instead. It contains new endpoints and much more functionality.

                                                                                                          Search issues

                                                                                                          Find issues by state and keyword.

                                                                                                          GET /legacy/issues/search/:owner/:repository/:state/:keyword
                                                                                                          

                                                                                                          Parameters

                                                                                                          Name Type Description
                                                                                                          state string Indicates the state of the issues to return. Can be either open or closed.
                                                                                                          keyword string The search term.
                                                                                                          Status: 200 OK
                                                                                                          
                                                                                                          {
                                                                                                            "issues": [
                                                                                                              {
                                                                                                                "gravatar_id": "",
                                                                                                                "position": 10,
                                                                                                                "number": 10,
                                                                                                                "votes": 2,
                                                                                                                "created_at": "2010-06-04T23:20:33Z",
                                                                                                                "comments": 5,
                                                                                                                "body": "Issue body goes here",
                                                                                                                "title": "This is is the issue title",
                                                                                                                "updated_at": "2010-06-04T23:20:33Z",
                                                                                                                "html_url": "https://github.com/pengwynn/linkedin/issues/10",
                                                                                                                "user": "ckarbass",
                                                                                                                "labels": [
                                                                                                                  "api",
                                                                                                                  "feature request",
                                                                                                                  "investigation"
                                                                                                                ],
                                                                                                                "state": "open"
                                                                                                              }
                                                                                                            ]
                                                                                                          }
                                                                                                          

                                                                                                          Search repositories

                                                                                                          Find repositories by keyword. Note, this legacy method does not follow the v3 pagination pattern. This method returns up to 100 results per page and pages can be fetched using the start_page parameter.

                                                                                                          GET /legacy/repos/search/:keyword
                                                                                                          

                                                                                                          Parameters

                                                                                                          Name Type Description
                                                                                                          keyword string The search term
                                                                                                          language string Filter results by language
                                                                                                          start_page string The page number to fetch
                                                                                                          sort string The sort field. One of stars, forks, or updated. Default: results are sorted by best match.
                                                                                                          order string The sort field. if sort param is provided. Can be either asc or desc.
                                                                                                          Status: 200 OK
                                                                                                          
                                                                                                          {
                                                                                                            "repositories": [
                                                                                                              {
                                                                                                                "type": "repo",
                                                                                                                "created": "2011-09-05T11:07:54Z",
                                                                                                                "watchers": 2913,
                                                                                                                "has_downloads": true,
                                                                                                                "username": "mathiasbynens",
                                                                                                                "homepage": "http://mths.be/dotfiles",
                                                                                                                "url": "https://github.com/mathiasbynens/dotfiles",
                                                                                                                "fork": false,
                                                                                                                "has_issues": true,
                                                                                                                "has_wiki": false,
                                                                                                                "forks": 520,
                                                                                                                "size": 192,
                                                                                                                "private": false,
                                                                                                                "followers": 2913,
                                                                                                                "name": "dotfiles",
                                                                                                                "owner": "mathiasbynens",
                                                                                                                "open_issues": 12,
                                                                                                                "pushed_at": "2012-06-05T03:37:13Z",
                                                                                                                "score": 3.289718,
                                                                                                                "pushed": "2012-06-05T03:37:13Z",
                                                                                                                "description": "sensible hacker defaults for OS X",
                                                                                                                "language": "VimL",
                                                                                                                "created_at": "2011-09-05T11:07:54Z"
                                                                                                              }
                                                                                                            ]
                                                                                                          }
                                                                                                          

                                                                                                          Search users

                                                                                                          Find users by keyword.

                                                                                                          GET /legacy/user/search/:keyword
                                                                                                          

                                                                                                          Parameters

                                                                                                          Name Type Description
                                                                                                          keyword string The search term
                                                                                                          start_page string The page number to fetch
                                                                                                          sort string The sort field. One of stars, forks, or updated. Default: results are sorted by best match.
                                                                                                          order string The sort field. if sort param is provided. Can be either asc or desc.
                                                                                                          Status: 200 OK
                                                                                                          
                                                                                                          {
                                                                                                            "users": [
                                                                                                              {
                                                                                                                "gravatar_id": "",
                                                                                                                "name": "Hirotaka Kawata",
                                                                                                                "created_at": "2009-10-05T01:32:06Z",
                                                                                                                "location": "Tsukuba, Ibaraki, Japan",
                                                                                                                "public_repo_count": 8,
                                                                                                                "followers": 10,
                                                                                                                "language": "Python",
                                                                                                                "fullname": "Hirotaka Kawata",
                                                                                                                "username": "techno",
                                                                                                                "id": "user-135050",
                                                                                                                "repos": 8,
                                                                                                                "type": "user",
                                                                                                                "followers_count": 10,
                                                                                                                "login": "techno",
                                                                                                                "score": 4.2559967,
                                                                                                                "created": "2009-10-05T01:32:06Z"
                                                                                                              }
                                                                                                            ]
                                                                                                          }
                                                                                                          

                                                                                                          Email search

                                                                                                          This API call is added for compatibility reasons only. There's no guarantee that full email searches will always be available. The @ character in the address must be left unencoded. Searches only against public email addresses (as configured on the user's GitHub profile).

                                                                                                          GET /legacy/user/email/:email
                                                                                                          

                                                                                                          Parameters

                                                                                                          Name Type Description
                                                                                                          email string The email address
                                                                                                          Status: 200 OK
                                                                                                          
                                                                                                          {
                                                                                                            "user": {
                                                                                                              "public_repo_count": 2,
                                                                                                              "public_gist_count": 1,
                                                                                                              "followers_count": 20,
                                                                                                              "following_count": 0,
                                                                                                              "created": "2009-10-05T01:32:06Z",
                                                                                                              "created_at": "2009-10-05T01:32:06Z",
                                                                                                              "name": "monalisa octocat",
                                                                                                              "company": "GitHub",
                                                                                                              "blog": "https://github.com/blog",
                                                                                                              "location": "San Francisco",
                                                                                                              "email": "octocat@github.com",
                                                                                                              "id": 2,
                                                                                                              "login": "octocat",
                                                                                                              "type": "User",
                                                                                                              "gravatar_id": ""
                                                                                                            }
                                                                                                          }
                                                                                                          
                                                                                                          tmp/developer.github.com/v3/troubleshooting/index.html Troubleshooting | GitHub Developer Guide

                                                                                                          Troubleshooting

                                                                                                          If you're encountering some oddities in the API, here's a list of resolutions to some of the problems you may be experiencing.

                                                                                                          Why am I getting a 404 error on a repository that exists?

                                                                                                          Typically, we send a 404 error when your client isn't properly authenticated. You might expect to see a 403 Forbidden in these cases. However, since we don't want to provide any information about private repositories, the API returns a 404 error instead.

                                                                                                          To troubleshoot, ensure you're authenticating correctly, your OAuth access token has the required scopes, and third-party application restrictions are not blocking access.

                                                                                                          Why am I not seeing all my results?

                                                                                                          Most API calls accessing a list of resources (e.g., users, issues, etc.) support pagination. If you're making requests and receiving an incomplete set of results, you're probably only seeing the first page. You'll need to request the remaining pages in order to get more results.

                                                                                                          It's important to not try and guess the format of the pagination URL. Not every API call uses the same structure. Instead, extract the pagination information from the Link Header, which is sent with every request.

                                                                                                          tmp/developer.github.com/v3/users/index.html Users | GitHub Developer Guide

                                                                                                          Users

                                                                                                          Many of the resources on the users API provide a shortcut for getting information about the currently authenticated user. If a request URL does not include a :username parameter then the response will be for the logged in user (and you must pass authentication information with your request). Additional private information, such as whether a user has two-factor authentication enabled, is included when authenticated through basic auth or OAuth with the user scope.

                                                                                                          Note: To help with migrating from our REST API v3 to GraphQL API v4, we're introducing a preview period to include the GraphQL node_id in the response for many REST API v3 resources. See the blog post for full details. To access node_id during the preview period, you must provide a custom media type in the Accept header:

                                                                                                          application/vnd.github.jean-grey-preview+json
                                                                                                          

                                                                                                          Warning: The API may change without advance notice during the preview period. Preview features are not supported for production use. If you experience any issues, contact GitHub support.

                                                                                                          Get a single user

                                                                                                          GET /users/:username
                                                                                                          

                                                                                                          Response

                                                                                                          Note: The returned email is the user's publicly visible email address (or null if the user has not specified a public email address in their profile). The publicly visible email address only displays for authenticated API users.

                                                                                                          Status: 200 OK
                                                                                                          
                                                                                                          {
                                                                                                            "login": "octocat",
                                                                                                            "id": 1,
                                                                                                            "avatar_url": "https://github.com/images/error/octocat_happy.gif",
                                                                                                            "gravatar_id": "",
                                                                                                            "url": "https://api.github.com/users/octocat",
                                                                                                            "html_url": "https://github.com/octocat",
                                                                                                            "followers_url": "https://api.github.com/users/octocat/followers",
                                                                                                            "following_url": "https://api.github.com/users/octocat/following{/other_user}",
                                                                                                            "gists_url": "https://api.github.com/users/octocat/gists{/gist_id}",
                                                                                                            "starred_url": "https://api.github.com/users/octocat/starred{/owner}{/repo}",
                                                                                                            "subscriptions_url": "https://api.github.com/users/octocat/subscriptions",
                                                                                                            "organizations_url": "https://api.github.com/users/octocat/orgs",
                                                                                                            "repos_url": "https://api.github.com/users/octocat/repos",
                                                                                                            "events_url": "https://api.github.com/users/octocat/events{/privacy}",
                                                                                                            "received_events_url": "https://api.github.com/users/octocat/received_events",
                                                                                                            "type": "User",
                                                                                                            "site_admin": false,
                                                                                                            "name": "monalisa octocat",
                                                                                                            "company": "GitHub",
                                                                                                            "blog": "https://github.com/blog",
                                                                                                            "location": "San Francisco",
                                                                                                            "email": "octocat@github.com",
                                                                                                            "hireable": false,
                                                                                                            "bio": "There once was...",
                                                                                                            "public_repos": 2,
                                                                                                            "public_gists": 1,
                                                                                                            "followers": 20,
                                                                                                            "following": 0,
                                                                                                            "created_at": "2008-01-14T04:33:35Z",
                                                                                                            "updated_at": "2008-01-14T04:33:35Z"
                                                                                                          }
                                                                                                          

                                                                                                          Get the authenticated user

                                                                                                          GET /user
                                                                                                          

                                                                                                          Response with public and private profile information

                                                                                                          Lists public and private profile information when authenticated through basic auth or OAuth with the user scope.

                                                                                                          Status: 200 OK
                                                                                                          
                                                                                                          {
                                                                                                            "login": "octocat",
                                                                                                            "id": 1,
                                                                                                            "avatar_url": "https://github.com/images/error/octocat_happy.gif",
                                                                                                            "gravatar_id": "",
                                                                                                            "url": "https://api.github.com/users/octocat",
                                                                                                            "html_url": "https://github.com/octocat",
                                                                                                            "followers_url": "https://api.github.com/users/octocat/followers",
                                                                                                            "following_url": "https://api.github.com/users/octocat/following{/other_user}",
                                                                                                            "gists_url": "https://api.github.com/users/octocat/gists{/gist_id}",
                                                                                                            "starred_url": "https://api.github.com/users/octocat/starred{/owner}{/repo}",
                                                                                                            "subscriptions_url": "https://api.github.com/users/octocat/subscriptions",
                                                                                                            "organizations_url": "https://api.github.com/users/octocat/orgs",
                                                                                                            "repos_url": "https://api.github.com/users/octocat/repos",
                                                                                                            "events_url": "https://api.github.com/users/octocat/events{/privacy}",
                                                                                                            "received_events_url": "https://api.github.com/users/octocat/received_events",
                                                                                                            "type": "User",
                                                                                                            "site_admin": false,
                                                                                                            "name": "monalisa octocat",
                                                                                                            "company": "GitHub",
                                                                                                            "blog": "https://github.com/blog",
                                                                                                            "location": "San Francisco",
                                                                                                            "email": "octocat@github.com",
                                                                                                            "hireable": false,
                                                                                                            "bio": "There once was...",
                                                                                                            "public_repos": 2,
                                                                                                            "public_gists": 1,
                                                                                                            "followers": 20,
                                                                                                            "following": 0,
                                                                                                            "created_at": "2008-01-14T04:33:35Z",
                                                                                                            "updated_at": "2008-01-14T04:33:35Z",
                                                                                                            "total_private_repos": 100,
                                                                                                            "owned_private_repos": 100,
                                                                                                            "private_gists": 81,
                                                                                                            "disk_usage": 10000,
                                                                                                            "collaborators": 8,
                                                                                                            "two_factor_authentication": true,
                                                                                                            "plan": {
                                                                                                              "name": "Medium",
                                                                                                              "space": 400,
                                                                                                              "private_repos": 20,
                                                                                                              "collaborators": 0
                                                                                                            }
                                                                                                          }
                                                                                                          

                                                                                                          Response with public profile information

                                                                                                          Lists public profile information when authenticated through OAuth without the user scope.

                                                                                                          Status: 200 OK
                                                                                                          
                                                                                                          {
                                                                                                            "login": "octocat",
                                                                                                            "id": 1,
                                                                                                            "avatar_url": "https://github.com/images/error/octocat_happy.gif",
                                                                                                            "gravatar_id": "",
                                                                                                            "url": "https://api.github.com/users/octocat",
                                                                                                            "html_url": "https://github.com/octocat",
                                                                                                            "followers_url": "https://api.github.com/users/octocat/followers",
                                                                                                            "following_url": "https://api.github.com/users/octocat/following{/other_user}",
                                                                                                            "gists_url": "https://api.github.com/users/octocat/gists{/gist_id}",
                                                                                                            "starred_url": "https://api.github.com/users/octocat/starred{/owner}{/repo}",
                                                                                                            "subscriptions_url": "https://api.github.com/users/octocat/subscriptions",
                                                                                                            "organizations_url": "https://api.github.com/users/octocat/orgs",
                                                                                                            "repos_url": "https://api.github.com/users/octocat/repos",
                                                                                                            "events_url": "https://api.github.com/users/octocat/events{/privacy}",
                                                                                                            "received_events_url": "https://api.github.com/users/octocat/received_events",
                                                                                                            "type": "User",
                                                                                                            "site_admin": false,
                                                                                                            "name": "monalisa octocat",
                                                                                                            "company": "GitHub",
                                                                                                            "blog": "https://github.com/blog",
                                                                                                            "location": "San Francisco",
                                                                                                            "email": "octocat@github.com",
                                                                                                            "hireable": false,
                                                                                                            "bio": "There once was...",
                                                                                                            "public_repos": 2,
                                                                                                            "public_gists": 1,
                                                                                                            "followers": 20,
                                                                                                            "following": 0,
                                                                                                            "created_at": "2008-01-14T04:33:35Z",
                                                                                                            "updated_at": "2008-01-14T04:33:35Z"
                                                                                                          }
                                                                                                          

                                                                                                          Update the authenticated user

                                                                                                          PATCH /user
                                                                                                          

                                                                                                          Note: If your email is set to private and you send an email parameter as part of this request to update your profile, your privacy settings are still enforced: the email address will not be displayed on your public profile or via the API.

                                                                                                          Parameters

                                                                                                          Name Type Description
                                                                                                          name string The new name of the user.
                                                                                                          email string The publicly visible email address of the user.
                                                                                                          blog string The new blog URL of the user.
                                                                                                          company string The new company of the user.
                                                                                                          location string The new location of the user.
                                                                                                          hireable boolean The new hiring availability of the user.
                                                                                                          bio string The new short biography of the user.

                                                                                                          Example

                                                                                                          {
                                                                                                            "name": "monalisa octocat",
                                                                                                            "email": "octocat@github.com",
                                                                                                            "blog": "https://github.com/blog",
                                                                                                            "company": "GitHub",
                                                                                                            "location": "San Francisco",
                                                                                                            "hireable": true,
                                                                                                            "bio": "There once..."
                                                                                                          }
                                                                                                          

                                                                                                          Response

                                                                                                          Status: 200 OK
                                                                                                          
                                                                                                          {
                                                                                                            "login": "octocat",
                                                                                                            "id": 1,
                                                                                                            "avatar_url": "https://github.com/images/error/octocat_happy.gif",
                                                                                                            "gravatar_id": "",
                                                                                                            "url": "https://api.github.com/users/octocat",
                                                                                                            "html_url": "https://github.com/octocat",
                                                                                                            "followers_url": "https://api.github.com/users/octocat/followers",
                                                                                                            "following_url": "https://api.github.com/users/octocat/following{/other_user}",
                                                                                                            "gists_url": "https://api.github.com/users/octocat/gists{/gist_id}",
                                                                                                            "starred_url": "https://api.github.com/users/octocat/starred{/owner}{/repo}",
                                                                                                            "subscriptions_url": "https://api.github.com/users/octocat/subscriptions",
                                                                                                            "organizations_url": "https://api.github.com/users/octocat/orgs",
                                                                                                            "repos_url": "https://api.github.com/users/octocat/repos",
                                                                                                            "events_url": "https://api.github.com/users/octocat/events{/privacy}",
                                                                                                            "received_events_url": "https://api.github.com/users/octocat/received_events",
                                                                                                            "type": "User",
                                                                                                            "site_admin": false,
                                                                                                            "name": "monalisa octocat",
                                                                                                            "company": "GitHub",
                                                                                                            "blog": "https://github.com/blog",
                                                                                                            "location": "San Francisco",
                                                                                                            "email": "octocat@github.com",
                                                                                                            "hireable": false,
                                                                                                            "bio": "There once was...",
                                                                                                            "public_repos": 2,
                                                                                                            "public_gists": 1,
                                                                                                            "followers": 20,
                                                                                                            "following": 0,
                                                                                                            "created_at": "2008-01-14T04:33:35Z",
                                                                                                            "updated_at": "2008-01-14T04:33:35Z",
                                                                                                            "total_private_repos": 100,
                                                                                                            "owned_private_repos": 100,
                                                                                                            "private_gists": 81,
                                                                                                            "disk_usage": 10000,
                                                                                                            "collaborators": 8,
                                                                                                            "two_factor_authentication": true,
                                                                                                            "plan": {
                                                                                                              "name": "Medium",
                                                                                                              "space": 400,
                                                                                                              "private_repos": 20,
                                                                                                              "collaborators": 0
                                                                                                            }
                                                                                                          }
                                                                                                          

                                                                                                          Get all users

                                                                                                          Lists all users, in the order that they signed up on GitHub. This list includes personal user accounts and organization accounts.

                                                                                                          Note: Pagination is powered exclusively by the since parameter. Use the Link header to get the URL for the next page of users.

                                                                                                          GET /users
                                                                                                          

                                                                                                          Parameters

                                                                                                          Name Type Description
                                                                                                          since string The integer ID of the last User that you've seen.

                                                                                                          Response

                                                                                                          Status: 200 OK
                                                                                                          Link: <https://api.github.com/users?since=135>; rel="next"
                                                                                                          
                                                                                                          [
                                                                                                            {
                                                                                                              "login": "octocat",
                                                                                                              "id": 1,
                                                                                                              "avatar_url": "https://github.com/images/error/octocat_happy.gif",
                                                                                                              "gravatar_id": "",
                                                                                                              "url": "https://api.github.com/users/octocat",
                                                                                                              "html_url": "https://github.com/octocat",
                                                                                                              "followers_url": "https://api.github.com/users/octocat/followers",
                                                                                                              "following_url": "https://api.github.com/users/octocat/following{/other_user}",
                                                                                                              "gists_url": "https://api.github.com/users/octocat/gists{/gist_id}",
                                                                                                              "starred_url": "https://api.github.com/users/octocat/starred{/owner}{/repo}",
                                                                                                              "subscriptions_url": "https://api.github.com/users/octocat/subscriptions",
                                                                                                              "organizations_url": "https://api.github.com/users/octocat/orgs",
                                                                                                              "repos_url": "https://api.github.com/users/octocat/repos",
                                                                                                              "events_url": "https://api.github.com/users/octocat/events{/privacy}",
                                                                                                              "received_events_url": "https://api.github.com/users/octocat/received_events",
                                                                                                              "type": "User",
                                                                                                              "site_admin": false
                                                                                                            }
                                                                                                          ]
                                                                                                          
                                                                                                          tmp/developer.github.com/v3/users/administration/index.html User Administration | GitHub Developer Guide

                                                                                                          Administration (Enterprise)

                                                                                                          The User Administration API allows you to promote, demote, suspend, and unsuspend users on a GitHub Enterprise appliance. It is only available to authenticated site administrators. Normal users will receive a 403 response if they try to access it.

                                                                                                          Prefix all the endpoints for this API with the following URL:

                                                                                                          http(s)://hostname/api/v3
                                                                                                          

                                                                                                          Promote an ordinary user to a site administrator

                                                                                                          PUT /users/:username/site_admin
                                                                                                          

                                                                                                          Note that you'll need to set Content-Length to zero when calling out to this endpoint. For more information, see "HTTP verbs."

                                                                                                          Response

                                                                                                          Status: 204 No Content
                                                                                                          

                                                                                                          Demote a site administrator to an ordinary user

                                                                                                          DELETE /users/:username/site_admin
                                                                                                          

                                                                                                          You can demote any user account except your own.

                                                                                                          Response

                                                                                                          Status: 204 No Content
                                                                                                          

                                                                                                          Suspend a user

                                                                                                          If your GitHub Enterprise appliance has LDAP Sync with Active Directory LDAP servers, this API is disabled and will return a 403 response. Users managed by an external account cannot be suspended via the API.

                                                                                                          PUT /users/:username/suspended
                                                                                                          

                                                                                                          You can suspend any user account except your own.

                                                                                                          Note that you'll need to set Content-Length to zero when calling out to this endpoint. For more information, see "HTTP verbs."

                                                                                                          Response

                                                                                                          Status: 204 No Content
                                                                                                          

                                                                                                          Unsuspend a user

                                                                                                          If your GitHub Enterprise appliance has LDAP Sync with Active Directory LDAP servers, this API is disabled and will return a 403 response. Users managed by an external account cannot be unsuspended via the API.

                                                                                                          DELETE /users/:username/suspended
                                                                                                          

                                                                                                          Response

                                                                                                          Status: 204 No Content
                                                                                                          
                                                                                                          tmp/developer.github.com/v3/users/blocking/index.html Block Another User | GitHub Developer Guide

                                                                                                          Block Another User

                                                                                                          Note: The User Blocking API on GitHub is currently available for developers to preview. To access the API, you must provide a custom media type in the Accept header:

                                                                                                          application/vnd.github.giant-sentry-fist-preview+json
                                                                                                          

                                                                                                          Warning: The API may change without advance notice during the preview period. Preview features are not supported for production use. If you experience any issues, contact GitHub support.

                                                                                                          List blocked users

                                                                                                          List the users you've blocked on your personal account.

                                                                                                          GET /user/blocks
                                                                                                          

                                                                                                          Response

                                                                                                          Status: 200 OK
                                                                                                          
                                                                                                          [
                                                                                                            {
                                                                                                              "login": "octocat",
                                                                                                              "id": 1,
                                                                                                              "avatar_url": "https://github.com/images/error/octocat_happy.gif",
                                                                                                              "gravatar_id": "",
                                                                                                              "url": "https://api.github.com/users/octocat",
                                                                                                              "html_url": "https://github.com/octocat",
                                                                                                              "followers_url": "https://api.github.com/users/octocat/followers",
                                                                                                              "following_url": "https://api.github.com/users/octocat/following{/other_user}",
                                                                                                              "gists_url": "https://api.github.com/users/octocat/gists{/gist_id}",
                                                                                                              "starred_url": "https://api.github.com/users/octocat/starred{/owner}{/repo}",
                                                                                                              "subscriptions_url": "https://api.github.com/users/octocat/subscriptions",
                                                                                                              "organizations_url": "https://api.github.com/users/octocat/orgs",
                                                                                                              "repos_url": "https://api.github.com/users/octocat/repos",
                                                                                                              "events_url": "https://api.github.com/users/octocat/events{/privacy}",
                                                                                                              "received_events_url": "https://api.github.com/users/octocat/received_events",
                                                                                                              "type": "User",
                                                                                                              "site_admin": false
                                                                                                            }
                                                                                                          ]
                                                                                                          

                                                                                                          Check whether you've blocked a user

                                                                                                          GET /user/blocks/:username
                                                                                                          

                                                                                                          Response

                                                                                                          If the user is blocked:

                                                                                                          Status: 204 No Content
                                                                                                          

                                                                                                          If the user is not blocked:

                                                                                                          Status: 404 Not Found
                                                                                                          

                                                                                                          Block a user

                                                                                                          PUT /user/blocks/:username
                                                                                                          

                                                                                                          Response

                                                                                                          Status: 204 No Content
                                                                                                          

                                                                                                          Unblock a user

                                                                                                          DELETE /user/blocks/:username
                                                                                                          

                                                                                                          Response

                                                                                                          Status: 204 No Content
                                                                                                          
                                                                                                          tmp/developer.github.com/v3/users/emails/index.html User Emails | GitHub Developer Guide

                                                                                                          Emails

                                                                                                          Management of email addresses via the API requires that you are authenticated through basic auth or OAuth with the user scope.

                                                                                                          List email addresses for a user

                                                                                                          GET /user/emails
                                                                                                          

                                                                                                          This endpoint is accessible with the user:email scope.

                                                                                                          Response

                                                                                                          Status: 200 OK
                                                                                                          Link: <https://api.github.com/resource?page=2>; rel="next",
                                                                                                                <https://api.github.com/resource?page=5>; rel="last"
                                                                                                          
                                                                                                          [
                                                                                                            {
                                                                                                              "email": "octocat@github.com",
                                                                                                              "verified": true,
                                                                                                              "primary": true,
                                                                                                              "visibility": "public"
                                                                                                            }
                                                                                                          ]
                                                                                                          

                                                                                                          List public email addresses for a user

                                                                                                          GET /user/public_emails
                                                                                                          

                                                                                                          This endpoint is accessible with the user:email scope.

                                                                                                          Response

                                                                                                          Status: 200 OK
                                                                                                          Link: <https://api.github.com/resource?page=2>; rel="next",
                                                                                                                <https://api.github.com/resource?page=5>; rel="last"
                                                                                                          
                                                                                                          [
                                                                                                            {
                                                                                                              "email": "octocat@github.com",
                                                                                                              "verified": true,
                                                                                                              "primary": true,
                                                                                                              "visibility": "public"
                                                                                                            }
                                                                                                          ]
                                                                                                          

                                                                                                          Add email address(es)

                                                                                                          POST /user/emails
                                                                                                          

                                                                                                          Input

                                                                                                          You can post a single email address or an array of addresses:

                                                                                                          [
                                                                                                            "octocat@github.com",
                                                                                                            "support@github.com"
                                                                                                          ]
                                                                                                          

                                                                                                          Response

                                                                                                          Status: 201 Created
                                                                                                          
                                                                                                          [
                                                                                                            {
                                                                                                              "email": "octocat@github.com",
                                                                                                              "primary": false,
                                                                                                              "verified": false
                                                                                                            },
                                                                                                            {
                                                                                                              "email": "support@github.com",
                                                                                                              "primary": false,
                                                                                                              "verified": false
                                                                                                            }
                                                                                                          ]
                                                                                                          

                                                                                                          Delete email address(es)

                                                                                                          DELETE /user/emails
                                                                                                          

                                                                                                          Input

                                                                                                          You can include a single email address or an array of addresses:

                                                                                                          [
                                                                                                            "octocat@github.com",
                                                                                                            "support@github.com"
                                                                                                          ]
                                                                                                          

                                                                                                          Response

                                                                                                          Status: 204 No Content
                                                                                                          

                                                                                                          Toggle primary email visibility

                                                                                                          PATCH /user/email/visibility
                                                                                                          

                                                                                                          Response

                                                                                                          Status: 200 OK
                                                                                                          
                                                                                                          [
                                                                                                            {
                                                                                                              "email": "octocat@github.com",
                                                                                                              "primary": true,
                                                                                                              "verified": true,
                                                                                                              "visibility": "private"
                                                                                                            }
                                                                                                          ]
                                                                                                          
                                                                                                          tmp/developer.github.com/v3/users/followers/index.html User Followers | GitHub Developer Guide

                                                                                                          Followers

                                                                                                          List followers of a user

                                                                                                          List a user's followers:

                                                                                                          GET /users/:username/followers
                                                                                                          

                                                                                                          List the authenticated user's followers:

                                                                                                          GET /user/followers
                                                                                                          

                                                                                                          Response

                                                                                                          Status: 200 OK
                                                                                                          Link: <https://api.github.com/resource?page=2>; rel="next",
                                                                                                                <https://api.github.com/resource?page=5>; rel="last"
                                                                                                          
                                                                                                          [
                                                                                                            {
                                                                                                              "login": "octocat",
                                                                                                              "id": 1,
                                                                                                              "avatar_url": "https://github.com/images/error/octocat_happy.gif",
                                                                                                              "gravatar_id": "",
                                                                                                              "url": "https://api.github.com/users/octocat",
                                                                                                              "html_url": "https://github.com/octocat",
                                                                                                              "followers_url": "https://api.github.com/users/octocat/followers",
                                                                                                              "following_url": "https://api.github.com/users/octocat/following{/other_user}",
                                                                                                              "gists_url": "https://api.github.com/users/octocat/gists{/gist_id}",
                                                                                                              "starred_url": "https://api.github.com/users/octocat/starred{/owner}{/repo}",
                                                                                                              "subscriptions_url": "https://api.github.com/users/octocat/subscriptions",
                                                                                                              "organizations_url": "https://api.github.com/users/octocat/orgs",
                                                                                                              "repos_url": "https://api.github.com/users/octocat/repos",
                                                                                                              "events_url": "https://api.github.com/users/octocat/events{/privacy}",
                                                                                                              "received_events_url": "https://api.github.com/users/octocat/received_events",
                                                                                                              "type": "User",
                                                                                                              "site_admin": false
                                                                                                            }
                                                                                                          ]
                                                                                                          

                                                                                                          List users followed by another user

                                                                                                          List who a user is following:

                                                                                                          GET /users/:username/following
                                                                                                          

                                                                                                          List who the authenticated user is following:

                                                                                                          GET /user/following
                                                                                                          

                                                                                                          Response

                                                                                                          Status: 200 OK
                                                                                                          Link: <https://api.github.com/resource?page=2>; rel="next",
                                                                                                                <https://api.github.com/resource?page=5>; rel="last"
                                                                                                          
                                                                                                          [
                                                                                                            {
                                                                                                              "login": "octocat",
                                                                                                              "id": 1,
                                                                                                              "avatar_url": "https://github.com/images/error/octocat_happy.gif",
                                                                                                              "gravatar_id": "",
                                                                                                              "url": "https://api.github.com/users/octocat",
                                                                                                              "html_url": "https://github.com/octocat",
                                                                                                              "followers_url": "https://api.github.com/users/octocat/followers",
                                                                                                              "following_url": "https://api.github.com/users/octocat/following{/other_user}",
                                                                                                              "gists_url": "https://api.github.com/users/octocat/gists{/gist_id}",
                                                                                                              "starred_url": "https://api.github.com/users/octocat/starred{/owner}{/repo}",
                                                                                                              "subscriptions_url": "https://api.github.com/users/octocat/subscriptions",
                                                                                                              "organizations_url": "https://api.github.com/users/octocat/orgs",
                                                                                                              "repos_url": "https://api.github.com/users/octocat/repos",
                                                                                                              "events_url": "https://api.github.com/users/octocat/events{/privacy}",
                                                                                                              "received_events_url": "https://api.github.com/users/octocat/received_events",
                                                                                                              "type": "User",
                                                                                                              "site_admin": false
                                                                                                            }
                                                                                                          ]
                                                                                                          

                                                                                                          Check if you are following a user

                                                                                                          GET /user/following/:username
                                                                                                          

                                                                                                          Response if you are following this user

                                                                                                          Status: 204 No Content
                                                                                                          

                                                                                                          Response if you are not following this user

                                                                                                          Status: 404 Not Found
                                                                                                          

                                                                                                          Check if one user follows another

                                                                                                          GET /users/:username/following/:target_user
                                                                                                          

                                                                                                          Response if user follows target user

                                                                                                          Status: 204 No Content
                                                                                                          

                                                                                                          Response if user does not follow target user

                                                                                                          Status: 404 Not Found
                                                                                                          

                                                                                                          Follow a user

                                                                                                          PUT /user/following/:username
                                                                                                          

                                                                                                          Note that you'll need to set Content-Length to zero when calling out to this endpoint. For more information, see "HTTP verbs."

                                                                                                          Following a user requires the user to be logged in and authenticated with basic auth or OAuth with the user:follow scope.

                                                                                                          Response

                                                                                                          Status: 204 No Content
                                                                                                          

                                                                                                          Unfollow a user

                                                                                                          DELETE /user/following/:username
                                                                                                          

                                                                                                          Unfollowing a user requires the user to be logged in and authenticated with basic auth or OAuth with the user:follow scope.

                                                                                                          Response

                                                                                                          Status: 204 No Content
                                                                                                          
                                                                                                          tmp/developer.github.com/v3/users/gpg_keys/index.html User GPG Keys | GitHub Developer Guide

                                                                                                          GPG Keys

                                                                                                          The data returned in the public_key response field is not a GPG formatted key. When a user uploads a GPG key, it is parsed and the cryptographic public key is extracted and stored. This cryptographic key is what is returned by the APIs on this page. This key is not suitable to be used directly by programs like GPG.

                                                                                                          List GPG keys for a user

                                                                                                          GET /users/:username/gpg_keys
                                                                                                          

                                                                                                          Lists the GPG keys for a user. This information is accessible by anyone.

                                                                                                          Response

                                                                                                          Status: 200 OK
                                                                                                          Link: <https://api.github.com/resource?page=2>; rel="next",
                                                                                                                <https://api.github.com/resource?page=5>; rel="last"
                                                                                                          
                                                                                                          [
                                                                                                            {
                                                                                                              "id": 3,
                                                                                                              "primary_key_id": null,
                                                                                                              "key_id": "3262EFF25BA0D270",
                                                                                                              "public_key": "xsBNBFayYZ...",
                                                                                                              "emails": [
                                                                                                                {
                                                                                                                  "email": "mastahyeti@users.noreply.github.com",
                                                                                                                  "verified": true
                                                                                                                }
                                                                                                              ],
                                                                                                              "subkeys": [
                                                                                                                {
                                                                                                                  "id": 4,
                                                                                                                  "primary_key_id": 3,
                                                                                                                  "key_id": "4A595D4C72EE49C7",
                                                                                                                  "public_key": "zsBNBFayYZ...",
                                                                                                                  "emails": [
                                                                                                          
                                                                                                                  ],
                                                                                                                  "subkeys": [
                                                                                                          
                                                                                                                  ],
                                                                                                                  "can_sign": false,
                                                                                                                  "can_encrypt_comms": true,
                                                                                                                  "can_encrypt_storage": true,
                                                                                                                  "can_certify": false,
                                                                                                                  "created_at": "2016-03-24T11:31:04-06:00",
                                                                                                                  "expires_at": null
                                                                                                                }
                                                                                                              ],
                                                                                                              "can_sign": true,
                                                                                                              "can_encrypt_comms": false,
                                                                                                              "can_encrypt_storage": false,
                                                                                                              "can_certify": true,
                                                                                                              "created_at": "2016-03-24T11:31:04-06:00",
                                                                                                              "expires_at": null
                                                                                                            }
                                                                                                          ]
                                                                                                          

                                                                                                          List your GPG keys

                                                                                                          GET /user/gpg_keys
                                                                                                          

                                                                                                          Lists the current user's GPG keys. Requires that you are authenticated via Basic Auth or via OAuth with at least read:gpg_key scope.

                                                                                                          Response

                                                                                                          Status: 200 OK
                                                                                                          Link: <https://api.github.com/resource?page=2>; rel="next",
                                                                                                                <https://api.github.com/resource?page=5>; rel="last"
                                                                                                          
                                                                                                          [
                                                                                                            {
                                                                                                              "id": 3,
                                                                                                              "primary_key_id": null,
                                                                                                              "key_id": "3262EFF25BA0D270",
                                                                                                              "public_key": "xsBNBFayYZ...",
                                                                                                              "emails": [
                                                                                                                {
                                                                                                                  "email": "mastahyeti@users.noreply.github.com",
                                                                                                                  "verified": true
                                                                                                                }
                                                                                                              ],
                                                                                                              "subkeys": [
                                                                                                                {
                                                                                                                  "id": 4,
                                                                                                                  "primary_key_id": 3,
                                                                                                                  "key_id": "4A595D4C72EE49C7",
                                                                                                                  "public_key": "zsBNBFayYZ...",
                                                                                                                  "emails": [
                                                                                                          
                                                                                                                  ],
                                                                                                                  "subkeys": [
                                                                                                          
                                                                                                                  ],
                                                                                                                  "can_sign": false,
                                                                                                                  "can_encrypt_comms": true,
                                                                                                                  "can_encrypt_storage": true,
                                                                                                                  "can_certify": false,
                                                                                                                  "created_at": "2016-03-24T11:31:04-06:00",
                                                                                                                  "expires_at": null
                                                                                                                }
                                                                                                              ],
                                                                                                              "can_sign": true,
                                                                                                              "can_encrypt_comms": false,
                                                                                                              "can_encrypt_storage": false,
                                                                                                              "can_certify": true,
                                                                                                              "created_at": "2016-03-24T11:31:04-06:00",
                                                                                                              "expires_at": null
                                                                                                            }
                                                                                                          ]
                                                                                                          

                                                                                                          Get a single GPG key

                                                                                                          View extended details for a single GPG key. Requires that you are authenticated via Basic Auth or via OAuth with at least read:gpg_key scope.

                                                                                                          GET /user/gpg_keys/:id
                                                                                                          

                                                                                                          Response

                                                                                                          Status: 200 OK
                                                                                                          
                                                                                                          {
                                                                                                            "id": 3,
                                                                                                            "primary_key_id": null,
                                                                                                            "key_id": "3262EFF25BA0D270",
                                                                                                            "public_key": "xsBNBFayYZ...",
                                                                                                            "emails": [
                                                                                                              {
                                                                                                                "email": "mastahyeti@users.noreply.github.com",
                                                                                                                "verified": true
                                                                                                              }
                                                                                                            ],
                                                                                                            "subkeys": [
                                                                                                              {
                                                                                                                "id": 4,
                                                                                                                "primary_key_id": 3,
                                                                                                                "key_id": "4A595D4C72EE49C7",
                                                                                                                "public_key": "zsBNBFayYZ...",
                                                                                                                "emails": [
                                                                                                          
                                                                                                                ],
                                                                                                                "subkeys": [
                                                                                                          
                                                                                                                ],
                                                                                                                "can_sign": false,
                                                                                                                "can_encrypt_comms": true,
                                                                                                                "can_encrypt_storage": true,
                                                                                                                "can_certify": false,
                                                                                                                "created_at": "2016-03-24T11:31:04-06:00",
                                                                                                                "expires_at": null
                                                                                                              }
                                                                                                            ],
                                                                                                            "can_sign": true,
                                                                                                            "can_encrypt_comms": false,
                                                                                                            "can_encrypt_storage": false,
                                                                                                            "can_certify": true,
                                                                                                            "created_at": "2016-03-24T11:31:04-06:00",
                                                                                                            "expires_at": null
                                                                                                          }
                                                                                                          

                                                                                                          Create a GPG key

                                                                                                          Creates a GPG key. Requires that you are authenticated via Basic Auth, or OAuth with at least write:gpg_key scope.

                                                                                                          POST /user/gpg_keys
                                                                                                          

                                                                                                          Input

                                                                                                          {
                                                                                                            "armored_public_key": "-----BEGIN PGP PUBLIC KEY BLOCK-----\n...\n-----END PGP PUBLIC KEY BLOCK-----"
                                                                                                          }
                                                                                                          

                                                                                                          Response

                                                                                                          Status: 201 Created
                                                                                                          Location:
                                                                                                          
                                                                                                          {
                                                                                                            "id": 3,
                                                                                                            "primary_key_id": null,
                                                                                                            "key_id": "3262EFF25BA0D270",
                                                                                                            "public_key": "xsBNBFayYZ...",
                                                                                                            "emails": [
                                                                                                              {
                                                                                                                "email": "mastahyeti@users.noreply.github.com",
                                                                                                                "verified": true
                                                                                                              }
                                                                                                            ],
                                                                                                            "subkeys": [
                                                                                                              {
                                                                                                                "id": 4,
                                                                                                                "primary_key_id": 3,
                                                                                                                "key_id": "4A595D4C72EE49C7",
                                                                                                                "public_key": "zsBNBFayYZ...",
                                                                                                                "emails": [
                                                                                                          
                                                                                                                ],
                                                                                                                "subkeys": [
                                                                                                          
                                                                                                                ],
                                                                                                                "can_sign": false,
                                                                                                                "can_encrypt_comms": true,
                                                                                                                "can_encrypt_storage": true,
                                                                                                                "can_certify": false,
                                                                                                                "created_at": "2016-03-24T11:31:04-06:00",
                                                                                                                "expires_at": null
                                                                                                              }
                                                                                                            ],
                                                                                                            "can_sign": true,
                                                                                                            "can_encrypt_comms": false,
                                                                                                            "can_encrypt_storage": false,
                                                                                                            "can_certify": true,
                                                                                                            "created_at": "2016-03-24T11:31:04-06:00",
                                                                                                            "expires_at": null
                                                                                                          }
                                                                                                          

                                                                                                          Delete a GPG key

                                                                                                          Removes a GPG key. Requires that you are authenticated via Basic Auth or via OAuth with at least admin:gpg_key scope.

                                                                                                          DELETE /user/gpg_keys/:id
                                                                                                          

                                                                                                          Response

                                                                                                          Status: 204 No Content
                                                                                                          
                                                                                                          tmp/developer.github.com/v3/users/keys/index.html User Public Keys | GitHub Developer Guide

                                                                                                          Public Keys

                                                                                                          List public keys for a user

                                                                                                          GET /users/:username/keys
                                                                                                          

                                                                                                          Lists the verified public keys for a user. This is accessible by anyone.

                                                                                                          Response

                                                                                                          Status: 200 OK
                                                                                                          Link: <https://api.github.com/resource?page=2>; rel="next",
                                                                                                                <https://api.github.com/resource?page=5>; rel="last"
                                                                                                          
                                                                                                          [
                                                                                                            {
                                                                                                              "id": 1,
                                                                                                              "key": "ssh-rsa AAA..."
                                                                                                            }
                                                                                                          ]
                                                                                                          

                                                                                                          List your public keys

                                                                                                          GET /user/keys
                                                                                                          

                                                                                                          Lists the current user's keys. Requires that you are authenticated via Basic Auth or via OAuth with at least read:public_key scope.

                                                                                                          Response

                                                                                                          Status: 200 OK
                                                                                                          Link: <https://api.github.com/resource?page=2>; rel="next",
                                                                                                                <https://api.github.com/resource?page=5>; rel="last"
                                                                                                          
                                                                                                          [
                                                                                                            {
                                                                                                              "id": 1,
                                                                                                              "key": "ssh-rsa AAA...",
                                                                                                              "url": "https://api.github.com/user/keys/1",
                                                                                                              "title": "octocat@octomac",
                                                                                                              "verified": true,
                                                                                                              "created_at": "2014-12-10T15:53:42Z",
                                                                                                              "read_only": true
                                                                                                            }
                                                                                                          ]
                                                                                                          

                                                                                                          Get a single public key

                                                                                                          View extended details for a single public key. Requires that you are authenticated via Basic Auth or via OAuth with at least read:public_key scope.

                                                                                                          GET /user/keys/:id
                                                                                                          

                                                                                                          Response

                                                                                                          Status: 200 OK
                                                                                                          
                                                                                                          {
                                                                                                            "id": 1,
                                                                                                            "key": "ssh-rsa AAA...",
                                                                                                            "url": "https://api.github.com/user/keys/1",
                                                                                                            "title": "octocat@octomac",
                                                                                                            "verified": true,
                                                                                                            "created_at": "2014-12-10T15:53:42Z",
                                                                                                            "read_only": true
                                                                                                          }
                                                                                                          

                                                                                                          Create a public key

                                                                                                          Creates a public key. Requires that you are authenticated via Basic Auth, or OAuth with at least write:public_key scope.

                                                                                                          POST /user/keys
                                                                                                          

                                                                                                          Input

                                                                                                          {
                                                                                                            "title": "octocat@octomac",
                                                                                                            "key": "ssh-rsa AAA..."
                                                                                                          }
                                                                                                          

                                                                                                          Response

                                                                                                          Status: 201 Created
                                                                                                          Location: https://api.github.com/user/keys/1
                                                                                                          
                                                                                                          {
                                                                                                            "id": 1,
                                                                                                            "key": "ssh-rsa AAA...",
                                                                                                            "url": "https://api.github.com/user/keys/1",
                                                                                                            "title": "octocat@octomac",
                                                                                                            "verified": true,
                                                                                                            "created_at": "2014-12-10T15:53:42Z",
                                                                                                            "read_only": true
                                                                                                          }
                                                                                                          

                                                                                                          Update a public key

                                                                                                          Public keys are immutable. If you need to update a public key, remove the key and create a new one instead.

                                                                                                          Delete a public key

                                                                                                          Removes a public key. Requires that you are authenticated via Basic Auth or via OAuth with at least admin:public_key scope.

                                                                                                          DELETE /user/keys/:id
                                                                                                          

                                                                                                          Response

                                                                                                          Status: 204 No Content
                                                                                                          
                                                                                                          tmp/developer.github.com/v3/versions/index.html Versions | GitHub Developer Guide

                                                                                                          Versions

                                                                                                          There are two stable versions of the GitHub API: the REST API v3 and the GraphQL API v4.

                                                                                                          When using the REST API v3, we encourage you to request v3 via the Accept header.

                                                                                                          Deprecated versions

                                                                                                          beta

                                                                                                          We deprecated the beta API on April 22, 2014.

                                                                                                          v2

                                                                                                          We removed support for API v2 on June 12, 2012.

                                                                                                          v1

                                                                                                          We removed support for API v1 on June 12, 2012.